快捷搜索:  as  2018  FtCWSyGV  С˵  test  xxx  Ψһ  w3viyKQx

澳门新葡亰上线了_龟发之家论坛



在用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(

__inHKEY hKey,

__inLPCTSTR lpSubKey,

__reservedDWORD Reserved,

__in_optLPTSTR lpClass,

__inDWORD dwOptions,

__inREGSAM samDesired,

__in_optLPSECURITY_ATTRIBUTES lpSecurityAttributes,

__outPHKEY phkResult,

__out_optLPDWORD lpdwDisposition

);

从MSDN中知道,它成功时返回的是ERROR_SUCCESS,其它值则是掉败,其它值便是类似GetLastError的差错码。这些差错码便是Windows Error Code。

Windows Error Codes

微软在WinError.h定义了大年夜量的Windows Error Codes,这种差错码范围是0x0000~0xF澳门新葡亰上线了FFF,即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.

所曩昔面的代码中,肴杂了HRESULT和Windows Error Code,分外是第一种代码,当注册表掉败澳门新葡亰上线了时它也会判断为成功,第2种由于两个都是0,可巧不会出问题,然则建议照样不要这么混用。

总结

参考资料

[MS-ERREF]: Windows Error Codes

http://msdn.microsoft.com/en-us/library/cc231196.aspx

HRESULT

http://msdn.microsoft.com/en-us/library/cc231198.aspx

2.2 Win32 Error Codes

http://msdn.microsoft.com/en-us/library/cc231199(v=PROT.10).aspx

2.3 NTSTATUS

http://msdn.microsoft.com/en-us/library/cc231200(v=PROT.10).aspx

Common HRESULT Values

http://msdn.microsoft.com/en-us/library/aa378137(VS.85).aspx

RegCreateKeyEx Function

http://msdn.microsoft.com/en-us/library/ms724844(VS.85).aspx

转自:http://www.cnblogs.com/greenerycn/archive/2010/08/30/hresult_and_win_error_codes.html

您可能还会对下面的文章感兴趣: