Fungsi GetPropertyQualifierSet

Mengambil kumpulan kualifikasi untuk properti tertentu.

Catatan

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

Sintaks

HRESULT GetPropertyQualifierSet (
   [in] int                 vFunc,
   [in] IWbemClassObject*   ptr,
   [in] LPCWSTR             wszProperty,
   [out] IWbemQualifierSet  **ppQualSet
);

Parameter

vFunc
[in] Parameter ini tidak digunakan.

ptr
[in] Penunjuk ke instans IWbemClassObject.

wszMethod
[in] Nama properti. wszProperty harus menunjuk ke LPCWSTR yang valid.

ppQualSet
[out] Menerima penunjuk antarmuka yang memungkinkan akses ke kualifikasi properti. ppQualSet tidak bisa menjadi null. Jika terjadi kesalahan, objek baru tidak dikembalikan dan penunjuk diatur untuk menunjuk ke null.

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_NOT_FOUND	0x80041002	Metode yang ditentukan tidak ada.
WBEM_E_OUT_OF_MEMORY	0x80041006	Tidak cukup memori yang tersedia untuk menyelesaikan operasi.
WBEM_E_INVALID_PARAMETER	0x80041008	Parameter adalah null.
WBEM_E_SYSTEM_PROPERTY	0x80041030	Fungsi ini mencoba untuk mendapatkan kualifikasi dari properti sistem.
WBEM_S_NO_ERROR	0	Panggilan fungsi berhasil.

Keterangan

Fungsi ini membungkus panggilan ke metode IWbemClassObject::GetPropertyQualifierSet.

Panggilan ke fungsi ini hanya didukung jika objek saat ini adalah definisi kelas CIM. Manipulasi metode tidak tersedia untuk penunjuk IWbemClassObject yang menunjuk ke instans CIM.

Karena setiap metode mungkin memiliki kualifikasinya sendiri, penunjuk IWbemQualifierSet memungkinkan pemanggil menambahkan, mengedit, atau menghapus kualifikasi ini.

Karena properti sistem tidak memiliki kualifikasi, fungsi akan mengembalikan WBEM_E_SYSTEM_PROPERTY jika Anda mencoba mendapatkan penunjuk IWbemQualifierSet untuk properti sistem.

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)