IDebugErrorEvent2::GetErrorMessage

Applies to: yesVisual Studio noVisual Studio for Mac

Note

This article applies to Visual Studio 2017. If you're looking for the latest Visual Studio documentation, see Visual Studio documentation. We recommend upgrading to the latest version of Visual Studio. Download it here

Returns information that allows construction of a human-readable error message.

Syntax

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
);

Parameters

pMessageType
[out] Returns a value from the MESSAGETYPE enumeration, describing the type of message.

pbstrErrorFormat
[out] The format of the final message to the user (see "Remarks" for details).

hrErrorReason
[out] The error code the message is about.

pdwType
[out] Severity of the error (use the MB_XXX constants for MessageBox; for example, MB_EXCLAMATION or MB_WARNING).

pbstrHelpFileName
[out] Path to a help file (set to a null value if there is no help file).

pdwHelpId
[out] ID of the help topic to display (set to 0 if there is no help topic).

Return Value

If successful, returns S_OK; otherwise, returns an error code.

Remarks

The error message should be formatted along the lines of "What I was doing. %1". The "%1" would then be replaced by the caller with the error message derived from the error code (which is returned in hrErrorReason). The pMessageType parameter tells the caller how the final error message should be displayed.

See also