Metode IWbemClassObject::GetMethod (wbemcli.h)

Artikel
08/27/2023

Metode IWbemClassObject::GetMethod mengembalikan informasi tentang metode yang diminta. Panggilan ini hanya didukung jika objek saat ini adalah definisi kelas CIM. Informasi metode tidak tersedia dari pointer IWbemClassObject yang menunjuk ke instans CIM.

Sintaks

HRESULT GetMethod(
  [in]  LPCWSTR          wszName,
  [in]  long             lFlags,
  [out] IWbemClassObject **ppInSignature,
  [out] IWbemClassObject **ppOutSignature
);

Parameter

[in] wszName

Nama metode. Ini tidak boleh NULL, dan harus menunjuk ke LPCWSTR yang valid.

[in] lFlags

Dicadangkan. Parameter ini harus berupa 0.

[out] ppInSignature

Pointer yang menerima pointer IWbemClassObject yang menjelaskan parameter dalam ke metode . Parameter ini diabaikan jika diatur ke NULL. Ketahuilah bahwa Manajemen Windows dapat mengatur penunjuk IWbemClassObject ke NULL jika metode ini tidak memiliki parameter. Untuk informasi selengkapnya, lihat Keterangan.

[out] ppOutSignature

Pointer yang menerima pointer IWbemClassObject yang menjelaskan parameter keluar ke metode . Parameter ini akan diabaikan jika diatur ke NULL.

Nilai kembali

Metode ini mengembalikan HRESULT yang menunjukkan status panggilan metode. Daftar berikut mencantumkan nilai yang terkandung dalam HRESULT. Untuk nilai HRESULT umum, lihat Kode Kesalahan Sistem.

Keterangan

Untuk metode , parameter masuk dan keluar dijelaskan sebagai properti dalam IWbemClassObject, instans kelas sistem __Parameters.

Misalnya, pertimbangkan metode berikut:

Class MyClass{
    [key] string KeyVal;
    sint32 PropVal;
    sint32 ExampleMethod([in] sint32 Parm1, [in] uint32 Parm2, 
      [out] string Parm3);
};

Dalam contoh ini, kelas memiliki satu metode. Ketika pengguna memanggil IWbemClassObject::GetMethod, parameter ppInSignature menerima objek IWbemClassObject , yang berisi dua properti: Parm1 dan Parm2. Parameter ppOutSignature berisi dua properti, Parm3 dan ReturnValue.

Setelah mengisi nilai properti objek ppInSignature , pemanggil dapat menggunakan objek untuk menjalankan metode dengan memanggil IWbemServices::ExecMethod atau IWbemServices::ExecMethodAsync.

Catatan Pemanggil harus memanggil IWbemClassObject::Release pada pointer ppInSignature dan ppOutSignature ketika objek ini tidak lagi diperlukan.

Persyaratan


Klien minimum yang didukung	Windows Vista
Server minimum yang didukung	Windows Server 2008
Target Platform	Windows
Header	wbemcli.h (termasuk Wbemidl.h)
Pustaka	WbemUuid.lib
DLL	CIMWin32.dll; Esscli.dll; Fastprox.dll; FrameDyn.dll; FrameDynOS.dll; Krnlprov.dll; Ncprov.dll; Wbemcore.dll; Wbemess.dll; Wmipiprt.dll

Lihat juga

IWbemClassObject

IWbemClassObject::P utMethod

Bagikan melalui