共用方式為


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 utMethodpInSignature 參數,指向系統類別的複本 __Parameters包含兩個屬性: Param1Param2pOutSignature 指向系統類別的複本,__Parameters包含兩個屬性:Param3ReturnValue

pOutSignature 所指向物件的 ReturnValue 屬性會決定方法傳回型別。 如果 pOutSignature 設定為 NULL,則會假設傳回類型為 VOID。

[in/out] 參數可以藉由將相同的屬性新增至 pInSignaturepOutSignature 參數所指向的兩個對象來定義。 在此情況下,屬性會共用相同的 ID 限定詞值。

ReturnValue 以外的__Parameters類別物件中的每個屬性都必須具有標識符限定符,這是以零起始的數值,可識別參數出現的順序。 在此範例中, Param1 會是 0、 Param2 1 和 Param3 2。 沒有兩個參數會有相同的 ID 值,而且無法略過任何 ID 值。 如果發生任一條件, IWbemClassObject::P utMethod 會傳回 WBEM_E_NONCONSECUTIVE_PARAMETER_IDS

注意當不再需要這些物件時,呼叫端必須在 pInSignaturepOutSignature 指標上呼叫 IWbemClassObject::Release
 

規格需求

需求
最低支援的用戶端 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

另請參閱

建立方法

IWbemClassObject

IWbemClassObject::GetMethod