通过

批注属性

  • 项目

[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