HRESULT傳回值說明

如果函數正常執行，則返回 S_OK，同時真正的函數運行結果則通過參數指標返回。如果遇到了異常情況，則COM系統經過判斷，會返回相應的錯誤值。HRESULT         值          含義
S_OK            0x00000000  成功
S_FALSE         0x00000001  函數成功執行完成，但返回時出現錯誤
E_INVALIDARG    0x80070057  參數有錯誤
E_OUTOFMEMORY   0x8007000E  記憶體申請錯誤
E_UNEXPECTED    0x8000FFFF  未知的異常
E_NOTIMPL       0x80004001  未實現功能
E_FAIL          0x80004005  沒有詳細說明的錯誤。一般需要取得 Rich Error 錯誤資訊(注1)
E_POINTER       0x80004003  無效的指標
E_HANDLE        0x80070006  無效的控制代碼
E_ABORT         0x80004004  終止操作
E_ACCESSDENIED  0x80070005  訪問被拒絕
E_NOINTERFACE   0x80004002  不支援介面

HRESULT 其實是一個雙位元組的值，其最高位(bit)如果是0表示成功，1表示錯誤。具體參見 MSDN 之"Structure of COM Error Codes"說明。我們在程式中如果需要判斷傳回值，則可以使用比較子號；switch開關語句；也可以使用VC提供的宏：

     HRESULT hr = 調用組件函數;
      if( SUCCEEDED( hr ) ){...} // 如果成功
      ......
      if( FAILED( hr ) ){...} // 如果失敗
      ......

大多數 COM 函數以及一些介面成員函數的傳回值類型均為 HRESULT 類型。HRESULT 類型的傳回值反映了函數中的一些情況，其類型定義規範如下：

   31 30 29 28                    16 15                                0
  |-----|--|------------------------|-----------------------------------|

類別碼 (30-31) 反映函數調用結果：
                00 調用成功
                01 包含一些資訊
                10 警告
                11 錯誤
自訂標籤(29) 反映結果是否為自訂標識，1 為是，0 則不是；
作業碼 (16-28) 標識結果操作來源，在 Windows 平台上，其定義如下：
                #define FACILITY_WINDOWS         8
                #define FACILITY_STORAGE         3
                #define FACILITY_RPC             1
                #define FACILITY_SSPI            9
                #define FACILITY_WIN32           7
                #define FACILITY_CONTROL         10
                #define FACILITY_NULL            0
                #define FACILITY_INTERNET        12
                #define FACILITY_ITF             4
                #define FACILITY_DISPATCH        2
                #define FACILITY_CERT            11
操作結果碼(0-15) 反映操作的狀態，WinError.h 定義了 Win32 函數所有可能返回結果。
                以下是一些經常用到的傳回值和宏定義：
                S_OK            函數執行成功，其值為 0 (注意，其值與 TRUE 相反)
                S_FALSE         函數執行成功，其值為 1
                S_FAIL          函數執行失敗，失敗原因不確定
                E_OUTOFMEMORY   函數執行失敗，失敗原因為記憶體配置不成功
                E_NOTIMPL       函數執行失敗，成員函數沒有被實現
                E_NOTINTERFACE  函數執行失敗，組件沒有實現指定的介面

不能簡單地把傳回值與 S_OK 和 S_FALSE 比較，而要用 SECCEEDED 和 FAILED 宏進行判斷。