Metode IWbemQualifierSet::GetNames (wbemcli.h)

Metode IWbemQualifierSet::GetNames mengambil nama semua kualifikasi yang tersedia dari objek atau properti saat ini. Secara bergantian, tergantung pada nilai filter IFlags, metode ini mengambil nama-nama kualifikasi tertentu.

Anda dapat mengakses kualifikasi ini berdasarkan nama, menggunakan IWbemQualifierSet::Get untuk setiap nama. Ini bukan kesalahan bagi objek tertentu untuk memiliki kualifikasi nol, sehingga jumlah string dalam pstrName saat dikembalikan bisa 0, meskipun WBEM_S_NO_ERROR kembali.

Sintaks

HRESULT GetNames(
  [in]  long      lFlags,
  [out] SAFEARRAY **pNames
);

Parameter

[in] lFlags

Salah satu konstanta berikut.

0 (Nol)

Kembalikan nama semua kualifikasi.

WBEM_FLAG_LOCAL_ONLY

Kembalikan hanya nama kualifikasi khusus untuk properti atau objek saat ini. Jika kumpulan kualifikasi saat ini mengacu pada properti, kembalikan hanya kualifikasi khusus untuk properti (termasuk penimpaan), dan bukan kualifikasi yang disebarluaskan dari definisi kelas. Jika kumpulan kualifikasi saat ini mengacu pada instans, hanya mengembalikan nama kualifikasi khusus instans. Jika kumpulan kualifikasi saat ini mengacu pada kelas, kembalikan hanya kualifikasi khusus untuk kelas yang diturunkan.

WBEM_FLAG_PROPAGATED_ONLY

Kembalikan hanya nama-nama kualifikasi yang disebarkan dari objek lain. Misalnya, jika kumpulan kualifikasi saat ini mengacu pada properti, kembalikan hanya kualifikasi yang disebarkan ke properti ini dari definisi kelas, dan bukan yang dari properti itu sendiri. Jika kumpulan kualifikasi saat ini mengacu pada instans, kembalikan hanya kualifikasi yang disebarluaskan dari definisi kelas. Jika kumpulan kualifikasi saat ini mengacu pada kelas, kembalikan hanya nama kualifikasi yang diwarisi dari kelas induk.

[out] pNames

SAFEARRAY baru dibuat yang berisi nama yang diminta.

Dalam semua kasus di mana tidak ada kesalahan yang dikembalikan, array baru dibuat dan pstrNames diatur untuk mengarahkannya. Ini terjadi meskipun array yang dihasilkan memiliki elemen nol. Jika terjadi kesalahan, SAFEARRAY baru tidak dikembalikan.

Nilai kembali

Metode ini mengembalikan HRESULT yang menunjukkan status panggilan metode. Daftar berikut mencantumkan nilai yang terkandung dalam HRESULT.

Keterangan

Untuk contoh penggunaan SAFEARRAYs BSTR, lihat Mengambil Bagian dari Instans WMI.

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	Fastprox.dll; Krnlprov.dll; Ncprov.dll; Wbemcore.dll

Lihat juga

IWbemQualifierSet

IWbemQualifierSet::BeginEnumeration

IWbemQualifierSet::Get