Error Handling in COM
Almost all COM functions and interface methods return a value of the type HRESULT. The HRESULT (for result handle) is a way of returning success, warning, and error values. HRESULTs are really not handles to anything; they are only values with several fields encoded in the value. As per the COM specification, a result of zero indicates success and a nonzero result indicates failure.
At the source code level, all error values consist of three parts, separated by underscores. The first part is the prefix that identifies the facility associated with the error, the second part is E for error, and the third part is a string that describes the actual condition. For example, STG_E_MEDIUMFULL is returned when there is no space left on a hard disk. The STG prefix indicates the storage facility, the E indicates that the status code represents an error, and the MEDIUMFULL provides specific information about the error. Many of the values that you might want to return from an interface method or function are defined in Winerror.h.
For more information about error handling, see the following sections:
- Structure of COM Error Codes
- Codes in FACILITY_ITF
- Using Macros for Error Handling
- COM Error Handling in Java and Visual Basic
- Error Handling Strategies
- Handling Unknown Errors