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

Question

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

typedef __success(return >= 0) long HRESULT;

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

Answer 1

This blog post on MSDN准确解释了什么__success表示:如果返回HRESULT，则表示函数成功值 >= 0。
注释只是描述一段代码的一种方式——它们本身不“做”任何事情，但可以让外部工具验证此类注释的语义。