optional 特性

[optional] 属性指定成员函数的可选参数。

return-type function-name([optional [, other-attributes]] parameter-type parameter-name)

parameters

return-type

指定函数的返回类型。

function-name

指定 IDL 文件中定义的函数的名称。

other-attributes

零个或多个可选 MIDL 属性。

parameter-type

可选参数的数据类型。

parameter-name

指定可选参数的名称。

备注

[optional] 属性仅当参数的类型为 VARIANTVARIANTÂ *时有效。

MIDL 编译器接受从左到右) (以下参数排序:

  1. 必需的参数 (没有 [defaultvalue][可选] 属性) 的参数,
  2. 具有或不带 [defaultvalue] 属性的可选参数,
  3. 具有 [可选] 属性且不包含 [defaultvalue] 属性的参数,
  4. [lcid] 参数(如果有)
  5. [retval] 参数

不能将 [可选] 属性应用于同时具有 [lcid][retval] 属性的参数。

示例

HRESULT MyFunc([in, optional] VARIANT Param1, 
               [out, optional] VARIANT Param2)

另请参阅

defaultvalue

使用 MIDL 生成类型库

lcid

ODL 文件示例

ODL 文件语法

retval