創造一種方法。
備註
此 API 僅供內部使用。 它不是用來從開發者程式碼中取得的。
語法
HRESULT PutMethod (
[in] int vFunc,
[in] IWbemClassObject* ptr,
[in] LPCWSTR wszName,
[in] LONG lFlags,
[in] IWbemClassObject* pInSignature,
[in] IWbemClassObject* pOutSignature
);
參數
vFunc [在]此參數未被使用。
ptr [在]一個指向 IWbemClassObject 實例的指標。
wszName [在]創造方法的名稱。
lFlags [在]保留的。 這個參數必須是 0。
pSignatureIn[在]指向包含in該方法參數的__Parameters系統類別的指標。 若設定為 null，則忽略此參數。
pSignatureOut[在]指向包含out該方法參數的__Parameters系統類別的指標。 若設定為 null，則忽略此參數。
返回值
以下由此函式回傳的值定義在 WbemCli.h 標頭檔案中，或你也可以將它們定義為程式碼中的常數：
| 常數 | 價值觀 | Description |
|---|---|---|
WBEM_E_INVALID_PARAMETER |
0x80041008 | 一或多個參數無效。 |
WBEM_E_INVALID_DUPLICATE_PARAMETER |
0x80041043 |
[in, out]
pInSignature 與 pOutSignature 物件中所指定的方法參數有不同的限定條件。 |
WBEM_E_MISSING_PARAMETER_ID |
0x80041036 | 某個方法參數缺少限定符的指定 ID 。 |
WBEM_E_NONCONSECUTIVE_PARAMETER_IDS |
0x80041038 | 分配給方法參數的 ID 系列不是連續的，或不是從 0 開始。 |
WBEM_E_PARAMETER_ID_ON_RETVAL |
0x80041039 | 方法的回傳值帶有 ID 限定符。 |
WBEM_E_PROPAGATED_METHOD |
0x80041034 | 曾嘗試重用父類別中現有的方法名稱，但簽名不匹配。 |
WBEM_S_NO_ERROR |
0 | 函式呼叫成功。 |
備註
此函式會包裹呼叫 IWbemClassObject：:P utMethod 方法。
此方法呼叫僅在 ptr 是 CIM 類別定義時被支援。 指向 CIM 實例的 IWbemClassObject 指標無法進行方法操作。
使用者無法建立以底線開頭或結尾的方法名稱。 這保留給系統類別和屬性。
對於方法， in 和 out 參數以 IWbemClassObject 物件中的屬性描述。
[in/out]參數可以透過將 和 pOutSignature 參數指向pInSignature的兩個物件加上相同的屬性來定義。 在這種情況下，這些屬性共享相同的 ID 限定值。
__Parameters類別物件中的每個屬性（除了 之外ReturnValue）都必須有一個ID限定詞，也就是以零為基礎的數值，用來識別參數出現的順序。 沒有兩個參數可以有相同的 ID 值，也不能 ID 跳過任何值。 若發生任一條件，函 PutMethod 數返回 WBEM_E_NONCONSECUTIVE_PARAMETER_IDS。
Example
舉例可參考 IWbemClassObject：:P utMethod 方法。
需求
平台：請參閱系統需求。
標題： WMINet_Utils.idl
.NET Framework 版本： 自 4.7.2 版本起可用
