_com_error

Microsoft Specific

A _com_error object represents an exception condition detected by the error-handling wrapper functions in the header files generated from the type library or by one of the COM support classes. The _com_error class encapsulates the HRESULT error code and any associated IErrorInfo object.

#include <comdef.h>

Compiler COM Support Class Overview

Construction

_com_error Constructs a _com_error object.

Operators

operator = Assigns an existing _com_error object to another.

Extractor Functions

Error Retrieves the HRESULT passed to the constructor.
ErrorInfo Retrieves the IErrorInfo object passed to the constructor.
WCode Retrieves the 16-bit error code mapped into the encapsulated HRESULT.

IErrorInfo functions

Description Calls IErrorInfo::GetDescription function.
HelpContext Calls IErrorInfo::GetHelpContext function.
HelpFile Calls IErrorInfo::GetHelpFile function
Source Calls IErrorInfo::GetSource function.
GUID Calls IErrorInfo::GetGUID function.

Format Message Extractor

ErrorMessage Retrieves the string message for HRESULT stored in the _com_error object.

ExepInfo.wCode to HRESULT Mappers

HRESULTToWCode Maps 32-bit HRESULT to 16-bit wCode.
WCodeToHRESULT Maps 16-bit wCode to 32-bit HRESULT.

END Microsoft Specific