Fungsi PutMethod

Membuat metode.

Nota

API ini hanya untuk penggunaan internal. Ini tidak dimaksudkan untuk digunakan dari kode pengembang.

Syntax

HRESULT PutMethod (
   [in] int                vFunc,
   [in] IWbemClassObject*  ptr,
   [in] LPCWSTR            wszName,
   [in] LONG               lFlags,
   [in] IWbemClassObject*  pInSignature,
   [in] IWbemClassObject*  pOutSignature
);

Parameter-parameternya

vFunc [di] Parameter ini tidak digunakan.

ptr [di] Pointer ke instans IWbemClassObject .

wszName [di] Nama metode yang akan dibuat.

lFlags [di] Dipesan. Parameter ini harus 0.

pSignatureIn [di] Penunjuk ke salinan kelas sistem __Parameters yang berisi in parameter untuk metode . Parameter ini diabaikan jika diatur ke null.

pSignatureOut [di] Penunjuk ke salinan kelas sistem __Parameters yang berisi out parameter untuk metode . Parameter ini diabaikan jika diatur ke null.

Mengembalikan nilai

Nilai berikut yang dikembalikan oleh fungsi ini didefinisikan dalam file header WbemCli.h , atau Anda dapat menentukannya sebagai konstanta dalam kode Anda:

Konstanta	Nilai	Description
WBEM_E_INVALID_PARAMETER	0x80041008	Satu atau beberapa parameter tidak valid.
WBEM_E_INVALID_DUPLICATE_PARAMETER	0x80041043	Parameter [in, out] metode yang ditentukan dalam objek pInSignature dan pOutSignature memiliki kualifikasi yang berbeda.
WBEM_E_MISSING_PARAMETER_ID	0x80041036	Parameter metode tidak memiliki spesifikasi ID kualifikasi.
WBEM_E_NONCONSECUTIVE_PARAMETER_IDS	0x80041038	Seri ID yang ditetapkan ke parameter metode tidak berturut-turut atau tidak dimulai pada 0.
WBEM_E_PARAMETER_ID_ON_RETVAL	0x80041039	Nilai pengembalian untuk metode memiliki ID kualifikasi.
WBEM_E_PROPAGATED_METHOD	0x80041034	Upaya dilakukan untuk menggunakan kembali nama metode yang ada dari kelas induk, dan tanda tangan tidak cocok.
WBEM_S_NO_ERROR	0	Panggilan fungsi berhasil.

Komentar

Fungsi ini membungkus panggilan ke metode IWbemClassObject::P utMethod .

Panggilan metode ini hanya didukung jika ptr merupakan definisi kelas CIM. Manipulasi metode tidak tersedia dari pointer IWbemClassObject yang menunjuk ke instans CIM.

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

Untuk metode , in parameter dan out dijelaskan sebagai properti dalam objek IWbemClassObject .

Parameter [in/out] dapat didefinisikan dengan menambahkan properti yang sama ke kedua objek yang pInSignature ditujukkan oleh parameter dan pOutSignature . Dalam hal ini, properti memiliki nilai kualifikasi yang sama ID .

Setiap properti dalam objek kelas __Parameters selain ReturnValue harus memiliki ID kualifikasi, nilai numerik berbasis nol yang mengidentifikasi urutan di mana parameter muncul. Tidak ada dua parameter yang dapat memiliki nilai yang sama ID , dan tidak ada ID nilai yang dapat dilewati. Jika salah satu kondisi terjadi, PutMethod fungsi mengembalikan WBEM_E_NONCONSECUTIVE_PARAMETER_IDS.

Example

Misalnya, lihat metode IWbemClassObject::P utMethod .

Persyaratan

Platform: Lihat Persyaratan Sistem.

Header: WMINet_Utils.idl

Versi .NET Framework: Tersedia sejak 4.7.2

Lihat juga

• WMI dan Penghitung Kinerja (Referensi API Tidak Terkelola)