参考MSDN(http://msdn.microsoft.com/en-us/library/aa383701.aspx)
Header annotation 表示一个函数怎样使用它的参数和返回值。
在编译器的命令行中增加 /analyze 开关可以进行代码分析,当你在函数中使用违反注解定义的语法规则时编译器可以进行提示。
有两种注解:缓冲区注解和高级注解
缓冲区注解
缓冲区注解表示函数怎样使用它的指针并能检测到缓冲区溢出,每个参数可有0或1个缓冲区注解。一个缓冲区注解由一个前导下划线和以下描述的组件组成。
缓冲区大小 | |
(size) | 指定缓冲区的总的大小,与_bcount 和 _ecount 一同使用;不要与_part 同时使用。这个值表示可访问的空间大小,它可能小于分配的空间。 |
(size,length) | 指定缓冲区的总的大小和初始分配空间的大小,与_bcount_part 和 _ecount_part 一同使用。这个值可能小于分配的空间。 |