visual-c++ - 这个宏有什么作用？__success(return >= 0) long

Question

在 Windows 头文件 WinNT.h 中，HRESULT 定义如下：

typedef __success(return >= 0) long HRESULT;

通过一些研究，我了解到“__success”宏是 Microsoft 源代码注释语言SAL的一部分，并在sal.h中定义。但是对于我的生活，我无法弄清楚它做了什么或它是如何做到的。

Answer 1

MSDN 上的这篇博文准确解释了含义：如果函数返回值 >= 0 __success，则表明函数成功。HRESULT

注释只是描述一段代码的一种方式——它们本身不会“做”任何事情，但可以让外部工具验证此类注释的语义。