optional 特性

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

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

参数

return-type

指定函数的返回类型。

function-name

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

other-attributes

零个或多个可选 MIDL 属性。

parameter-type

可选参数的数据类型。

parameter-name

指定可选参数的名称。

注解

仅当参数的类型为 VARIANT 或 VARIANTÂ *时,[可选] 属性才有效。

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