PutMethod 函式
建立方法。
注意
此 API 僅供內部使用。 不是要讓您在開發人員程式碼中使用。
語法
HRESULT PutMethod (
[in] int vFunc,
[in] IWbemClassObject* ptr,
[in] LPCWSTR wszName,
[in] LONG lFlags,
[in] IWbemClassObject* pInSignature,
[in] IWbemClassObject* pOutSignature
);
參數
vFunc
[in] 此參數未使用。
ptr
[in] IWbemClassObject 執行個體的指標。
wszName
[in] 要建立的方法名稱。
lFlags
[in] 保留。 這個參數必須是 0。
pSignatureIn
[in] __Parameters system class 複本的指標，包含方法的 in 參數。 如果此參數設定為 null，則會將其忽略。
pSignatureOut
[in] __Parameters system class 複本的指標，包含方法的 out 參數。 如果此參數設定為 null，則會將其忽略。
傳回值
此函式傳回的下列值定義於 WbemCli.h 標頭檔中，或者，您可以將其定義為程式碼中的常數：
| 常數 | 值 | 描述 |
|---|---|---|
WBEM_E_INVALID_PARAMETER |
0x80041008 | 一或多個參數無效。 |
WBEM_E_INVALID_DUPLICATE_PARAMETER |
0x80041043 | pInSignature 和 pOutSignature 物件中指定的 [in, out] 方法參數有不同的限定詞。 |
WBEM_E_MISSING_PARAMETER_ID |
0x80041036 | 方法參數未指定 ID 限定詞。 |
WBEM_E_NONCONSECUTIVE_PARAMETER_IDS |
0x80041038 | 指派給方法參數的識別碼數列不連續，或是未從 0 開始。 |
WBEM_E_PARAMETER_ID_ON_RETVAL |
0x80041039 | 方法的傳回值具有 ID 限定詞。 |
WBEM_E_PROPAGATED_METHOD |
0x80041034 | 嘗試重複使用來自父類別的現有方法名稱，並且簽章不符。 |
WBEM_S_NO_ERROR |
0 | 函式呼叫成功。 |
備註
此函式會包裝對 IWbemClassObject::PutMethod 方法的呼叫。
只有在 ptr 是 CIM 類別定義時，才支援此方法呼叫。 無法從指向 CIM 執行個體的 IWbemClassObject 指標操作方法。
使用者無法建立名稱開頭或結尾為底線的方法。 這會保留給系統類別和屬性。
方法會將 in 和 out 參數描述為 IWbemClassObject 物件中的屬性。
您可以透過 pInSignature 和 pOutSignature 參數將相同的屬性新增至所指向的兩個物件，以定義 [in/out] 參數。 在此情況下，屬性會共用相同的 ID 限定詞值。
__Parameters 類別物件中的每個屬性 (ReturnValue 除外) 都必須具有 ID 限定詞，這是以零起始的數值，可識別參數的出現順序。 沒有兩個參數會有相同的 ID 值，而且無法略過任何 ID 值。 如果發生任一情況，PutMethod 函式便會傳回 WBEM_E_NONCONSECUTIVE_PARAMETER_IDS。
範例
如需範例，請參閱 IWbemClassObject::PutMethod 方法。
規格需求
平台：請參閱系統需求。
標頭：WMINet_Utils.idl
.NET Framework版本：自 4.7.2 起提供
