in 屬性

[in]屬性工作表示參數是從呼叫程式傳遞至呼叫程式。

[ [function-attribute-list] ] type-specifier [pointer-declarator] function-name(
    [ in [ , parameter-attribute-list ] ] type-specifier [declarator]
    , ...);

參數

function-attribute-list

指定套用至函式的零個或多個屬性。 有效的函式屬性為[callback][local]、指標屬性[ref][unique][ptr],以及使用屬性[string]、[ignore][coNtext_handle]。

type-specifier

指定 base_type結構等位列舉 類型識別碼。 選擇性儲存體規格可以位於 類型規範之前。

pointer-declarator

指定零個或多個指標宣告子。 指標宣告子與 C 中使用的指標宣告子相同;它是由 * 指示項、 方修飾詞和限定詞 常數所建構。

function-name

指定遠端程式的名稱。

parameter-attribute-list

指定零個或多個適用于指定參數類型的屬性。 具有[in]屬性的參數屬性也可以採用方向屬性[out];欄位屬性[first_is][last_is]、[length_is]、[max_is][size_is][switch_type];指標屬性[ref][unique][ptr];和使用量屬性[coNtext_handle][string]。 使用屬性 [ignore] 不能當做參數屬性使用。 以逗號分隔多個屬性。

宣告子

指定標準 C 宣告子,例如識別碼、指標宣告子和陣列宣告子。 如需詳細資訊,請參閱 陣列和Sized-Pointer屬性陣列陣列和指標。 函式宣告子中的參數宣告子,例如參數名稱是選擇性的。

備註

[in]屬性具有相反的屬性[out],表示參數是從呼叫的程式傳回給呼叫程式。 [in][out]屬性稱為方向參數屬性,因為它們會指定傳遞參數的方向。 參數可以定義為 [in][out][inout]

[in]屬性會識別用戶端存根為了傳輸至伺服器而封送處理的參數。

[in]屬性預設會在未指定方向參數屬性時套用至參數。

範例

HRESULT MyFunction([in] short count);

另請參閱

介面定義 (IDL) 檔案

midl_user_allocate

out