使用英语阅读

通过


批注属性

[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

指定 base_type[结构]联合[枚举] 类型或类型标识符。 可选的存储规范可以在 类型说明符之前。

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 ,则忽略此属性。

另请参阅

常规 MIDL 命令行语法

/萨尔

/sal_local