Metode IWbemClassObject::GetNames (wbemcli.h)
Metode IWbemClassObject::GetNames mengambil nama properti dalam objek . Selain itu, tergantung pada kriteria pilihan yang disediakan pengguna, ia dapat mengambil semua atau subset properti. Properti ini kemudian dapat diakses dengan menggunakan IWbemClassObject::Get untuk setiap nama. Metode ini juga dapat mengembalikan properti sistem.
Sintaks
HRESULT GetNames(
[in] LPCWSTR wszQualifierName,
[in] long lFlags,
[in] VARIANT *pQualifierVal,
[out] SAFEARRAY **pNames
);
Parameter
[in] wszQualifierName
Parameter yang bisa NULL. Jika bukan NULL, itu harus menunjuk ke LPCWSTR yang valid yang menentukan nama kualifikasi yang beroperasi sebagai bagian dari filter. Ini ditangani sebagai baca-saja. Untuk informasi selengkapnya, lihat Keterangan.
[in] lFlags
Untuk informasi selengkapnya, lihat Keterangan.
[in] pQualifierVal
Parameter yang bisa NULL. Jika bukan NULL, itu harus menunjuk ke struktur VARIAN yang valid yang diinisialisasi ke nilai filter. VARIAN ini ditangani sebagai baca-saja dengan metode . Dengan demikian, penelepon harus memanggil VariantClear di atasnya, jika diperlukan. Untuk informasi selengkapnya, lihat Keterangan.
[out] pNames
Parameter yang tidak boleh NULL, tetapi pada entri parameter ini harus menunjuk ke NULL. Struktur SAFEARRAY baru selalu dialokasikan, dan penunjuk diatur untuk mengarahkannya. Array yang dikembalikan dapat memiliki 0 elemen, tetapi selalu dialokasikan saat WBEM_S_NO_ERROR kembali. Jika terjadi kesalahan, struktur SAFEARRAY baru tidak dikembalikan.
Mengembalikan nilai
Metode ini mengembalikan HRESULT yang menunjukkan status panggilan metode. Daftar berikut mencantumkan nilai yang terkandung dalam HRESULT. Untuk nilai HRESULT umum, lihat Kode Kesalahan Sistem.
Keterangan
Nama yang dikembalikan dikontrol oleh kombinasi bendera dan parameter. Misalnya, semua nama semua properti dapat ditentukan, atau hanya properti kunci yang dapat ditentukan, dan sebagainya. Filter utama ditentukan dalam parameter lFlags ; parameter lain bervariasi tergantung padanya.
Nilai bendera adalah bidang bit, dan dapat digabungkan. Satu bendera dari masing-masing grup berikut dapat digabungkan dengan bendera dari masing-masing grup lainnya. Nilai bendera dalam grup saling eksklusif.
| Bendera grup 1 | Deskripsi |
|---|---|
| WBEM_FLAG_ALWAYS | Mengembalikan semua nama properti. Parameter strQualifierName dan pQualifierVal tidak digunakan. |
| WBEM_FLAG_ONLY_IF_TRUE | Mengembalikan hanya properti yang memiliki kualifikasi nama yang ditentukan oleh parameter strQualifierName. Jika bendera ini digunakan, Anda harus menentukan strQualifierName. |
| WBEM_FLAG_ONLY_IF_FALSE | Mengembalikan hanya properti yang tidak memiliki kualifikasi nama yang ditentukan oleh parameter strQualifierName. Jika bendera ini digunakan, Anda harus menentukan strQualifierName. |
| WBEM_FLAG_ONLY_IF_IDENTICAL | Mengembalikan hanya properti yang memiliki kualifikasi nama yang ditentukan oleh parameter QualifierName, dan juga memiliki nilai yang identik dengan nilai yang ditentukan oleh struktur VARIAN yang diacu oleh pQualifierVal. Jika bendera ini digunakan, Anda harus menentukan QualifierName dan pQualifierVal. |
| Bendera grup 2 | Deskripsi |
|---|---|
| WBEM_FLAG_KEYS_ONLY | Mengembalikan hanya nama properti atau properti yang menentukan kunci. |
| WBEM_FLAG_REFS_ONLY | Hanya mengembalikan nama properti yang merupakan referensi objek. |
| Bendera grup 3 | Deskripsi |
|---|---|
| WBEM_FLAG_LOCAL_ONLY | Kembalikan hanya nama properti yang termasuk dalam kelas turunan paling banyak. Kecualikan properti dari kelas induk atau kelas induk. |
| WBEM_FLAG_PROPAGATED_ONLY | Hanya mengembalikan nama properti yang termasuk dalam kelas induk atau kelas induk. |
| WBEM_FLAG_SYSTEM_ONLY | Mengembalikan hanya properti sistem. |
| WBEM_FLAG_NONSYSTEM_ONLY | Kembalikan hanya nama properti yang bukan properti sistem. |
Ini bukan kesalahan untuk daftar kosong yang akan dikembalikan dalam kasus di mana tidak ada properti yang cocok dengan filter yang ditentukan.
Untuk informasi selengkapnya tentang menggunakan struktur SAFEARRAY dari nilai BSTR , lihat Mengambil Bagian dari Instans WMI.
Persyaratan
| 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 | CIMWin32.dll; Esscli.dll; Fastprox.dll; FrameDyn.dll; FrameDynOS.dll; Krnlprov.dll; Ncprov.dll; Wbemcore.dll; Wbemess.dll; Wmipiprt.dll |