Fungsi Get

Mengambil nilai properti yang ditentukan jika ada.

Catatan

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

Sintaks

HRESULT Get (
   [in] int               vFunc,
   [in] IWbemClassObject* ptr,
   [in] LPCWSTR           wszName,
   [in] LONG              lFlags,
   [out] VARIANT*         pVal,
   [out] CIMTYPE*         pvtType,
   [out] LONG*            plFlavor
);

Parameter

vFunc
[in] Parameter ini tidak digunakan.

ptr
[in] Penunjuk ke instans IWbemClassObject.

wszName
[in] Nama properti.

lFlags
[in] Dipesan. Parameter ini harus 0.

pVal
[out] Jika fungsi berhasil dikembalikan, berisi nilai properti wszName. Argumen pval diberi jenis dan nilai yang benar untuk kualifikasi.

pvtType
[out] Jika fungsi berhasil dikembalikan, berisi konstanta jenis CIM yang menunjukkan jenis properti. Nilainya juga dapat berupa null.

plFlavor
[out] Jika fungsi berhasil dikembalikan, menerima informasi tentang asal properti. Nilainya dapat berupa null, atau salah satu konstanta WBEM_FLAVOR_TYPE berikut yang ditentukan dalam file header WbemCli.h:

Terus-menerus	Nilai	Deskripsi
WBEM_FLAVOR_ORIGIN_SYSTEM	0x40	Properti adalah properti sistem standar.
WBEM_FLAVOR_ORIGIN_PROPAGATED	0x20	Untuk kelas: Properti diwarisi dari kelas induk. Misalnya: Properti, meskipun diwarisi dari kelas induk, belum diubah oleh instans.
WBEM_FLAVOR_ORIGIN_LOCAL	0	Untuk kelas: Properti milik kelas turunan. Misalnya: Properti diubah oleh instans; yaitu, nilai disediakan, atau kualifikasi ditambahkan atau diubah.

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_FAILED	0x80041001	Terjadi kegagalan umum.
WBEM_E_INVALID_PARAMETER	0x80041008	Satu atau beberapa parameter tidak valid.
WBEM_E_NOT_FOUND	0x80041002	Properti yang ditentukan tidak ditemukan.
WBEM_E_OUT_OF_MEMORY	0x80041006	Memori tidak cukup tersedia untuk menyelesaikan operasi.
WBEM_S_NO_ERROR	0	Panggilan fungsi berhasil.

Keterangan

Fungsi ini membungkus panggilan ke metode IWbemClassObject::Get.

Fungsi Get juga dapat mengembalikan properti sistem.

Argumen pVal diberi jenis dan nilai yang benar untuk kualifikasi dan fungsi VariantInit COM

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)