批注属性
[annotate] 属性允许您为指定的方法、参数或结构字段指定 SAL 注释字符串。
[ annotation(“stringâ€0, [, function-attribute-list] ] function-declarator ;
[ [function-attribute-list] ] type-specifier [pointer-declarator] function-name(
[ annotation(“stringâ€) [ , parameter-attribute-list ] ] type-specifier [declarator]
, ...);
-
string
-
指定的 SAL 批注字符串。
-
function-attribute-list
-
指定应用于函数的零个或多个属性。 有效的函数属性包括 [callback];指针属性 [ref]、[unique]或 [ptr];和用法属性 [string]、[ignore] 和 [context_handle]。 多个属性必须用逗号分隔。
-
function-declarator
-
指定函数的类型说明符、函数名称和参数列表。
-
type-specifier
-
pointer-declarator
-
指定零个或多个指针声明符。 指针声明符与 C 中使用的指针声明符相同;它由 * 指示符、修饰符(如 far)和限定符 [const] 构造。
-
function-name
-
指定远程过程的名称。
-
parameter-attribute-list
-
指定适用于参数类型的零个或多个属性。 具有 [in] 属性的参数属性也可以采用方向属性 [out];字段属性 [first_is]、 [last_is]、 [length_is]、 [max_is]、 [size_is]和 [switch_type];指针属性 [ref]、 [unique]或 [ptr];和用法属性 [context_handle] 和 [string]。 usage 属性 [ignore] 不能用作参数属性。 多个属性必须用逗号分隔。
-
declarator
-
指定标准 C 声明符,例如标识符、指针声明符和数组声明符。 有关详细信息,请参阅 数组和Sized-Pointer属性、 [arrays]和 数组和指针。 函数声明符中的参数声明符(例如参数名称)是可选的。
[annotate] 属性允许重写 MIDL 生成的 SAL 注释,或在 MIDL 未显式生成批注的位置添加它们。 如果未在命令行上指定 /sal ,则忽略此属性。