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、 結構、 等位或 列舉 類型或類型識別碼。 選擇性的儲存體規格可以在 type-specifier之前。
-
pointer-declarator
-
指定零個或多個指標宣告子。 指標宣告子與 C 中使用的指標宣告子相同;它是從 * 指示項、 遠方修飾詞和限定詞 const所建構。
-
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]或 [in, out]。
[in]屬性會識別由用戶端存根封送處理以傳輸至伺服器的參數。
未指定方向參數屬性時,預設會將 [in] 屬性套用至參數。
範例
HRESULT MyFunction([in] short count);
另請參閱