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