HRESULT用法

HRESULT 常被用作COM调用的返回值。充分利用HRESULT返回信息可以帮助提高我们的代码质量，提供程序的健壮性。以下是HRESULT用法小结：

1. HRESULT 值及其含义。

S_OK 操作成功 0x00000000

S_FALSE 函数调用成功 #define S_FALSE ((HRESULT)1L)

E_UNEXPECTED 意外的失败 0x8000FFFF 　　

E_NOTIMPL 未实现 0x80004001 　　

E_OUTOFMEMORY 未能分配所需的内存 0x8007000E 　　

E_INVALIDARG 一个或多个参数无效 0x80070057 　　

E_NOINTERFACE 不支持此接口 0x80004002 　　

E_POINTER 无效指针 0x80004003 　　

E_HANDLE 无效句柄 0x80070006 　　

E_ABORT 操作已中止 0x80004004 　　

E_FAIL 未指定的失败 0x80004005 　　

E_ACCESSDENIED 一般的访问被拒绝错误 0x80070005

2.HRESULT使用方法。

其中最常用的是S_OK,S_FALSE,E_FAIL.

S_OK 操作成功，调用成功。需要用SUCCEEDED(hr) 来判断。

#define SUCCEEDED(hr) (((HRESULT)(hr)) >= 0)

S_FALSE 函数调用成功，可以处理有问题。需要用（hr == S_FALSE）来判断

E_FAIL 未指定的失败，一般来讲是函数调用错误。需要用（hr == E_FAIL） 来判断。

从以上分析可以看出，FAILED 泛指一切错误。

#define FAILED(hr) (((HRESULT)(hr)) < 0)

举例如下：

public static HRESULT Save(	CATDocument&	iDocument,
	CATBoolean	iSavePointedIfNecessary	= TRUE)

Returns:

S_OK : The document was saved successfully.

S_FALSE : The document does not need to be saved.

E_FAIL : The document save operation failed.
转自：/article/11026967.html