Understanding SAL

http://msdn.microsoft.com/zh-cn/library/hh916383%28v=vs.110%29.aspx

 

SAL: Microsoft source-code annotation language

相关标注在 sal.h 中定义

 

The Microsoft source-code annotation language (SAL) provides a set of annotations that you can use to describe how a function uses its parameters, the assumptions that it makes about them, and the guarantees that it makes when it finishes.

Simply stated, SAL is an inexpensive way to let the compiler check your code for you.

SAL 定义了四个基本的参数：

_In_　　　  以只读方式向函数传递数据
_Inout_　   以可读可写的方式传递数据
_Out_       向函数提供写入地址
_Outptr_    同上，但函数以指针形式返回被写入的地址