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。

注意當不再需要這些物件時，呼叫端必須在 pInSignature 和 pOutSignature 指標上呼叫 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