Partilhar via


IDebugErrorEvent2::GetErrorMessage

Retorna informações que permite a construção de uma mensagem de erro legível.

HRESULT GetErrorMessage(
   MESSAGETYPE* pMessageType,
   BSTR*        pbstrErrorFormat,
   HRESULT*     hrErrorReason,
   DWORD*       pdwType,
   BSTR*        pbstrHelpFileName,
   DWORD*       pdwHelpId
);
int GetErrorMessage(
   out enum_MESSAGETYPE   pMessageType,
   out string             pbstrErrorFormat,
   out int                phrErrorReason,
   out uint               pdwType,
   out string             pbstrHelpFileName,
   out uint               pdwHelpId
);

Parâmetros

  • pMessageType
    [out] Retorna um valor a partir do MESSAGETYPE enumeração, que descreve o tipo de mensagem.

  • pbstrErrorFormat
    [out] O formato da mensagem para o usuário final (consulte "Comentários" para obter detalhes).

  • hrErrorReason
    [out] O código de erro a mensagem é sobre.

  • pdwType
    [out] Gravidade do erro (usar as constantes MB_XXX para MessageBox; for example, MB_EXCLAMATION or MB_WARNING).

  • pbstrHelpFileName
    [out] Caminho para um arquivo de Ajuda (definido como um valor nulo se não houver nenhum arquivo de ajuda).

  • pdwHelpId
    [out] ID do tópico da Ajuda para exibir (definido como 0 se não houver nenhum tópico da Ajuda).

Valor de retorno

Se bem-sucedida, retorna S_OK; Caso contrário, retorna um código de erro.

Comentários

A mensagem de erro deve ser formatada ao longo das linhas de "What I was doing. %1". O "%1" deve ser substituído pelo chamador com a mensagem de erro derivada do código de erro (que é retornado em hrErrorReason). O pMessageType parâmetro informa o chamador como a mensagem de erro final deve ser exibida.

Consulte também

Referência

IDebugErrorEvent2

MESSAGETYPE