Metode IWbemClassObject::P utMethod (wbemcli.h)

Artikel
03/03/2024

IWbemClassObject::P utMethod digunakan untuk membuat metode. Panggilan ini hanya didukung jika objek saat ini adalah definisi kelas CIM. Manipulasi metode tidak tersedia dari penunjuk IWbemClassObject yang menunjuk ke instans.

Pengguna tidak dapat membuat metode dengan nama yang dimulai atau diakhpuni dengan garis bawah. Ini disediakan untuk kelas dan properti sistem.

Sintaks

HRESULT PutMethod(
  [in] LPCWSTR          wszName,
  [in] long             lFlags,
  [in] IWbemClassObject *pInSignature,
  [in] IWbemClassObject *pOutSignature
);

Parameter

[in] wszName

Nama metode yang dibuat.

[in] lFlags

Dicadangkan. Parameter ini harus 0 (nol).

[in] pInSignature

Penunjuk ke salinan kelas sistem __Parameters yang berisi parameter dalam untuk metode . Parameter ini diabaikan jika diatur ke NULL.

[in] pOutSignature

Penunjuk ke salinan kelas sistem __Parameters yang berisi parameter keluar untuk objek . Parameter ini 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 objek IWbemClassObject .

Misalnya, pertimbangkan metode berikut:

Class MyClass{
    [key] string KeyVal;
    sint32 PropVal;
    sint32 ExampleMethod([in] sint32 Param1, [in] uint32 Param2, 
        [out] string Param3);
    HRESULT ReturnValue;
};

Dalam contoh sebelumnya, kelas memiliki satu metode. Untuk membuat metode secara terprogram, pengguna memanggil IWbemClassObject::P utMethod dengan parameter pInSignature yang menunjuk ke salinan kelas sistem __Parameters yang berisi dua properti: Param1 dan Param2. pOutSignature menunjuk ke salinan __Parameters kelas sistem yang berisi dua properti: Param3 dan ReturnValue.

Properti ReturnValue dari objek yang diarahkan oleh pOutSignature menentukan jenis pengembalian metode. Jika pOutSignature diatur ke NULL, jenis pengembalian diasumsikan sebagai VOID.

Parameter [masuk/keluar] dapat ditentukan dengan menambahkan properti yang sama ke kedua objek yang diarahkan oleh parameter pInSignature dan pOutSignature . Dalam hal ini, properti berbagi nilai kualifikasi ID yang sama.

Setiap properti dalam objek kelas __Parameters selain ReturnValue harus memiliki kualifikasi ID , numerik berbasis nol yang mengidentifikasi urutan di mana parameter muncul. Dalam contoh ini, Param1 adalah 0, Param2 1, dan Param3 2. Tidak ada dua parameter yang dapat memiliki nilai ID yang sama dan tidak ada nilai ID yang dapat dilewati. Jika salah satu kondisi terjadi, IWbemClassObject::P utMethod mengembalikan WBEM_E_NONCONSECUTIVE_PARAMETER_IDS.

Catatan Penelepon harus memanggil IWbemClassObject::Release pada pointer pInSignature dan pOutSignature ketika objek ini tidak lagi diperlukan.

Persyaratan

Persyaratan	Nilai
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

Membuat Metode

IWbemClassObject

IWbemClassObject::GetMethod

Bagikan melalui