IWbemClassObject::P utMethod 方法 (wbemcli.h)
IWbemClassObject::P utMethod 是用來建立方法。 只有在目前的物件是 CIM 類別定義時,才支援此呼叫。 無法從指向 CIM 執行個體的 IWbemClassObject 指標操作方法。
用戶無法建立名稱開頭或結尾為底線的方法。 這會保留給系統類別和屬性。
語法
HRESULT PutMethod(
[in] LPCWSTR wszName,
[in] long lFlags,
[in] IWbemClassObject *pInSignature,
[in] IWbemClassObject *pOutSignature
);
參數
[in] wszName
所建立的方法名稱。
[in] lFlags
保留的。 此參數必須是 0 (零) 。
[in] pInSignature
__Parameters 系統類別 的指標,其中包含 方法之 參數中的 。 如果設定為 NULL,則會忽略此參數。
[in] pOutSignature
包含物件之 out 參數 之__Parameters 系統類別複本的指標。 如果設定為 NULL,則會忽略此參數。
傳回值
這個方法會傳回 HRESULT ,指出方法呼叫的狀態。 下列清單列出 HRESULT 中包含的值。 如需一般 HRESULT 值,請參閱 系統錯誤碼。
備註
針對方法,in 和 out 參數會描述為 IWbemClassObject 物件中的屬性。
例如,請考慮下列方法:
Class MyClass{
[key] string KeyVal;
sint32 PropVal;
sint32 ExampleMethod([in] sint32 Param1, [in] uint32 Param2,
[out] string Param3);
HRESULT ReturnValue;
};
在上一個範例中,類別有一個方法。 若要以程序設計方式建立方法,使用者會呼叫 IWbemClassObject::P utMethod 與 pInSignature 參數,指向系統類別的複本 , __Parameters包含兩個屬性: Param1 和 Param2。 pOutSignature 指向系統類別的複本,__Parameters包含兩個屬性:Param3 和 ReturnValue。
pOutSignature 所指向物件的 ReturnValue 屬性會決定方法傳回型別。 如果 pOutSignature 設定為 NULL,則會假設傳回類型為 VOID。
[in/out] 參數可以藉由將相同的屬性新增至 pInSignature 和 pOutSignature 參數所指向的兩個對象來定義。 在此情況下,屬性會共用相同的 ID 限定詞值。
ReturnValue 以外的__Parameters類別物件中的每個屬性都必須具有標識符限定符,這是以零起始的數值,可識別參數出現的順序。 在此範例中, Param1 會是 0、 Param2 1 和 Param3 2。 沒有兩個參數會有相同的 ID 值,而且無法略過任何 ID 值。 如果發生任一條件, IWbemClassObject::P utMethod 會傳回 WBEM_E_NONCONSECUTIVE_PARAMETER_IDS。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows Vista |
最低支援的伺服器 | Windows Server 2008 |
目標平台 | Windows |
標頭 | wbemcli.h (包含 Wbemidl.h) |
程式庫 | WbemUuid.lib |
Dll | CIMWin32.dll;Esscli.dll;Fastprox.dll;FrameDyn.dll;FrameDynOS.dll;Krnlprov.dll;Ncprov.dll;Wbemcore.dll;Wbemess.dll;Wmipiprt.dll |