Função AMGetErrorTextW (errors.h)

A função AMGetErrorText recupera a mensagem de erro para um determinado código de retorno, usando a configuração de idioma atual.

Essa função converte HRESULT retornar códigos em mensagens de erro. A constante MAX_ERROR_TEXT_LEN especifica o número máximo de caracteres em uma mensagem de erro.

Sintaxe

AMOVIEAPI DWORD AMGetErrorTextW(
  HRESULT hr,
  LPWSTR  pbuffer,
  DWORD   MaxLen
);

Parâmetros

hr

valor HRESULT.

pbuffer

Ponteiro para um buffer de caracteres que recebe a mensagem de erro.

MaxLen

Número de caracteres em pBuffer.

Valor de retorno

Retorna o número de caracteres retornados no buffer ou zero se ocorreu um erro.

Observações

Nota

O cabeçalho errors.h define AMGetErrorText como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito Valor
da Plataforma de Destino Windows
cabeçalho errors.h
biblioteca Quartzo.lib

Consulte também

Funções