Fungsi GetPropertyHandle

Mengembalikan handel unik yang mengidentifikasi properti.

Catatan

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

Sintaks

HRESULT GetPropertyHandle (
   [in] int                  vFunc,
   [in] IWbemObjectAccess*   ptr,
   [in] LPCWSTR              wszPropertyName,
   [out] CIMTYPE*            pType,
   [out] long*               pHandle
);

Parameter

vFunc
[in] Parameter ini tidak digunakan.

ptr
[in] Penunjuk ke instans IWbemObjectAccess.

wszPropertyName
[in] String null yang dihentikan dari karakter yang dikodekan UTF16 yang berisi nama properti.

pType
[out] Penunjuk ke anggota enumerasi CIMTYPE yang mewakili jenis CIM properti.

pHandle
[out] Penunjuk ke bilangan bulat yang berisi handel properti.

Mengembalikan nilai

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

Terus-menerus	Nilai	Deskripsi
WBEM_E_NOT_FOUND	0x80041002	Nama properti yang ditentukan tidak ditemukan.
WBEM_E_INVALID_PARAMETER	0x80041008	Parameter tidak valid.
WBEM_E_NOT_SUPPORTED	0x8004100c	Properti yang diminta berjenis CIM_OBJECT atau CIM_ARRAY.
WBEM_S_NO_ERROR	0	Panggilan fungsi berhasil.

Keterangan

Fungsi ini membungkus panggilan ke metode IWbemClassObject::GetPropertyHandle.

Anda dapat menggunakan handel ini untuk mengidentifikasi properti saat menggunakan metode IWbemObjectAccess untuk membaca atau menulis nilai properti.

Handel dapat diambil untuk properti semua jenis data selain CIM_OBJECT dan CIM_ARRAY. Handel yang dikembalikan berfungsi di semua instans kelas.

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)