可選屬性

[optional] 屬性指定了成員函式的可選參數。

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

參數

回傳型

指定函式的回傳類型。

函數名稱

指定 IDL 檔案中定義的函式名稱。

其他屬性

零或多個可選的 MIDL 屬性。

參數型別

可選參數的資料型態。

參數名稱

指定可選參數的名稱。

備註

[optional] 屬性僅在參數型別為 VARIANTVARIANT * 時有效。

MIDL 編譯器接受以下參數排序方式(從左至右):

  1. 必要參數(不含 [defaultvalue][optional] 屬性的參數),
  2. 可選參數可有或無 [defaultvalue] 屬性,
  3. 帶有 [optional] 屬性且未包含 [defaultvalue] 屬性的參數,
  4. [LCID] 參數,如果有的話,
  5. [retval] 參數

你不能將 [optional] 屬性套用到同時具有 [lcid][retval] 屬性的參數上。

Examples

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

另請參閱

預設值

使用 MIDL 產生型別函式庫

LCID

ODL 檔案範例

ODL 檔案語法

雷特瓦爾