什么是_Use_decl_annotations_含义

use*_*148 9 c c++ driver

我是SAL的新手.我想知道_Use_decl_annotations_的含义.我从MSDN学习:http: //msdn.microsoft.com/en-us/library/jj159529.aspx.

"可以在函数定义(也称为函数体)上使用,而不是标题中的注释列表.当使用_Use_decl_annotations_时,使用相同函数的范围内标题中出现的注释,就像使用它们也出现在具有_Use_decl_annotations_注释的定义中."

但是,我无法进入它.何时以及为什么要在功能上使用它?

IIn*_*ble 12

此批注指示静态代码分析工具在分析函数定义时从声明中获取注释.

例如,当您实现作为标头和二进制文件发布的API时,这很有用.在这种情况下,您通常希望为API的用户提供与实现使用的SAL注释相同的注释.为了防止注释的重复,公共头文件中的函数声明用SAL注释进行修饰,私有实现使用_Use_decl_annotations_相同的注释来进行静态代码分析.