HRESULT中关于S_OK,S_FALSE和 E_FAIL浅析

最新推荐文章于 2023-05-15 17:31:47 发布

转载最新推荐文章于 2023-05-15 17:31:47 发布 · 6.8k 阅读

文章标签：

本文深入探讨了COM服务器中常用的HRESULT返回值S_OK、S_FALSE和E_FAIL的意义及用法。通过解析HRESULT的布局，解释了这三个返回值在程序逻辑和错误处理中的作用。同时强调了S_FALSE和S_OK的区别，指出S_FALSE虽然表示成功，但结果可能不符合预期。最后，提供了一种判断返回值的方法，即使用SUCCEEDED和FAILED宏来确保程序能够正确响应不同的返回状态。

S_OK是COM服务器返回正确

S_FALSE是COM服务器返回错误，不过这个错误是可以不处理的，不影响程序正常运行。只是结果不是想要的

E_FAIL是必须处理的错误。

//
//  HRESULTs are 32 bit values layed out as follows:
//
//   3 3 2 2 2 2 2 2 2 2 2 2 1 1 1 1 1 1 1 1 1 1
//   1 0 9 8 7 6 5 4 3 2 1 0 9 8 7 6 5 4 3 2 1 0 9 8 7 6 5 4 3 2 1 0
//  +-+-+-+-+-+---------------------+-------------------------------+
//  |S|R|C|N|r|    Facility         |               Code            |
//  +-+-+-+-+-+---------------------+-------------------------------+
//
//  where
//
//      S - Severity - indicates success/fail
//
//          0 - Success
//          1 - Fail (COERROR)

#define E_FAIL                                 _HRESULT_TYPEDEF_(0x80004005L)

#define S_OK                                   ((HRESULT)0x00000000L)
#define S_FALSE                                ((HRESULT)0x00000001L)

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

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

返回E_FAIL，是告诉调用程序－－某些地方出错，必须进行处理。否则，程序不能进行下去了。

返回S_FALSE，不是表示出现错误。

而S_OK和S_FALSE，则程序逻辑的不同表示。如果将它们表示成S_1和S_2可能更好理解些！

调用程序只需对返回的S_OK和S_FALSE进行判断，然后决定程序的走向。

最主要的误解是由S_FALSE的名称带来的。

所以在使用SUCCEEDED和FAILED来判断返回值的时候，需注意S_FALSE也表示成功，只是其结果并不是想要的，因此FAILED(S_FALSE)返回为"非"，SUCCEEDED同理。

当自己写的函数接口返回值为HRESULT的时候，如果想要指明其出错，并且必须被处理时，应返回E_FAIL.