深入HRESULT與Windows Error Codes的區別詳解

2020-01-26 16:11:25

字體：大中小

來源：轉載

供稿：網友

在用C++來開發Windows程序時，經常看到下面的判斷情況：

HRESULT hr = ::RegCreateKeyEx(hk, szKeyPath, 0, NULL, REG_OPTION_NON_VOLATILE, KEY_QUERY_VALUE, NULL, &hk, NULL);
if (SUCCEEDED(hr)) 
{

在代碼中，使用SUCCEEDED宏來判斷函數RegCreateKeyEx()函數的返回值。
有些程序員認為RegCreateKeyEx返回0的時候就是成功，而S_OK就是0，所以就習慣性的用SUCCEEDED宏來做判斷。
還有些人用下面的方法判斷，看起來更嚴謹一些：

復制代碼代碼如下:

HRESULT hr = ::RegCreateKeyEx(hk, szKeyPath, 0, NULL, REG_OPTION_NON_VOLATILE, KEY_QUERY_VALUE, NULL, &hk, NULL);
if (S_OK == hr) 
{

確實，第2種更嚴謹一些，至少不會造成大問題，而第1中則完全是一個大Bug，這個bug在正常情況下是沒有問題的。但一旦有問題，你也發現不了。
錯在哪里呢？聽我下面來介紹。

SUCCEEDED
先看下這個宏的定義（WinError.h)：

復制代碼代碼如下:

//
// Generic test for success on any status value (non-negative numbers
// indicate success).
//
#define SUCCEEDED(hr) ((HRESULT)(hr) >= 0)

從這里可以看出，它就是把hr轉換成HRESULT類型，然后做了下是否大于0的判斷。注釋中也說明：但值為非負數時表示成功。
也就是說，只要HRESULT是大于等于0的值，它就認為是成功的。

HRESULT
再來看下HRESULT的定義(winnt.h)：

復制代碼代碼如下:

// Component Object Model defines, and macros
#ifndef _HRESULT_DEFINED
#define _HRESULT_DEFINED
typedef LONG HRESULT;
#endif // !_HRESULT_DEFINED

哦，原來HRESULT就是一個Long型的整數。
在MSDN中，可以查到更加詳細的資料：

如上圖，HRESULT是一個4字節的Long型，總共32位。其中：
第31位是s位，即符號位，因為HRESUlT格式規定所有成功都是正的整數，失敗的值都是負數
第30位是r位，是保留位，但n位（28位）沒有設置時，它必須是0；如果n位使用了，則和s位一起來標識NTSTATUS的值。
第29位是c位，表示Custom，即自定義位，如果是微軟定義的返回值，則該位為0；如果是自定義的，則該位為1.
第28位是n位，表示NTSTATUS，值為0的話可以把NTSTATUS值映射為一個HRESULT值。
第27位是x位，保留位，必須為0.
第26位到第16位是Facility，用11位來表示錯誤來源，比如

復制代碼代碼如下:

FACILITY_WINDOWS 表示來自Windows子系統

第15位到第1位是Code位，用來保存錯誤值。

從這里可以看出，只有最后面的2個字節是用來表示返回值的其它的都是輔助信息，它主要用于COM函數的返回值。

常見HRESULT值

Name	Description	Value
S_OK	操作成功	0x00000000
S_FALSE	操作成功，但是有問題	0x00000001L
E_ABORT	操作中止	0x80004004
E_ACCESSDENIED	拒絕訪問	0x80070005
E_FAIL	未知錯誤	0x80004005

注意：除了S_OK外，還有一個S_FALSE，它也屬于成功。
所以，微軟為了方便大家使用，專門提供了SUCCEEDED宏和FAILED宏來方便大家做判斷。
到這里，大家明白了吧：SUCCEEDED宏是用來判斷COM中的函數執行是否成功用的，失敗為負數，成功為0和正數。

Windows Error Code
前面的代碼中我們調用了一個Windows API：

復制代碼代碼如下:

:RegCreateKeyEx(hk, szKeyPath, 0, NULL, REG_OPTION_NON_VOLATILE, KEY_QUERY_VALUE, NULL, &hk, NULL);

這個API的聲明是：

復制代碼代碼如下:

LONG WINAPI RegCreateKeyEx(
  __in        HKEY hKey,
  __in        LPCTSTR lpSubKey,
  __reserved  DWORD Reserved,
  __in_opt    LPTSTR lpClass,
  __in        DWORD dwOptions,
  __in        REGSAM samDesired,
  __in_opt    LPSECURITY_ATTRIBUTES lpSecurityAttributes,
  __out       PHKEY phkResult,
  __out_opt   LPDWORD lpdwDisposition
);

從MSDN中知道，它成功時返回的是ERROR_SUCCESS，其它值則是失敗，其它值就是類似GetLastError的錯誤碼。這些錯誤碼就是Windows Error Code。

Windows Error Codes
微軟在WinError.h定義了大量的Windows Error Codes，這種錯誤碼范圍是0x0000~0xFFFF，即2個字節，但沒限定死2個字節，也可以用4個字節來保存。在Windows API中，大量的使用了這種錯誤碼。比如上面的注冊表API，它的返回值就是這種錯誤碼。
這種錯誤碼還有個特點是微軟為這些錯誤碼定義了比較詳細的可閱讀的描述信息，它可以通過FormatMessage函數來獲得，在中文環境下，顯示的是翻譯后的中文。

Windows Error Codes 除了ERROR_SUCCESS外，都是正數，也就是不能用SUCCEEDED宏來判斷，因為這個宏只判斷是不是非負數，對于它而言，所有的Windows Error Codes都是成功的。

常見的Windows Error Codes

Win32 error codes	Description
0x00000000 ERROR_SUCCESS	The operation completed successfully.
0x00000000 NERR_Success	The operation completed successfully.
0x00000001 ERROR_INVALID_FUNCTION	Incorrect function.
0x00000002 ERROR_FILE_NOT_FOUND	The system cannot find the file specified.
0x00000003 ERROR_PATH_NOT_FOUND	The system cannot find the path specified.
0x00000004 ERROR_TOO_MANY_OPEN_FILES	The system cannot open the file.
0x00000005 ERROR_ACCESS_DENIED	Access is denied.