optional 屬性

[選擇性]屬性會指定成員函式的選擇性參數。

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

參數

return-type

指定函式的傳回型別。

function-name

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

other-attributes

零個或多個選擇性 MIDL 屬性。

parameter-type

選擇性參數的資料類型。

parameter-name

指定選擇性參數的名稱。

備註

只有在參數的類型為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