Metode IWbemContext::GetNames (wbemcli.h)
Metode IWbemContext::GetNames mengembalikan struktur SAFEARRAY dari semua nama nilai konteks bernama. Setelah semua nama diketahui, GetValue dapat dipanggil pada setiap nama untuk mengambil nilai. Teknik ini adalah cara mengakses nilai konteks yang berbeda dari memanggil metode BeginEnumeration, Next, dan EndEnumeration .
Sintaks
HRESULT GetNames(
[in] long lFlags,
[out] SAFEARRAY **pNames
);
Parameter
[in] lFlags
Dicadangkan. Parameter ini harus berupa 0.
[out] pNames
Parameter ini tidak boleh NULL, tetapi pada entri harus menunjuk ke NULL. Jika tidak ada kesalahan yang dikembalikan, pada pstrName keluar menerima penunjuk ke struktur jenis SAFEARRAY baru VT_BSTR yang berisi semua nama nilai konteks. Pemanggil harus memanggil SafeArrayDestroy pada penunjuk yang dikembalikan ketika array tidak lagi diperlukan. Jika kode kesalahan dikembalikan, penunjuk dibiarkan tidak dimodifikasi.
Nilai kembali
Metode ini mengembalikan HRESULT yang menunjukkan status panggilan metode. Daftar berikut mencantumkan nilai yang terkandung dalam HRESULT.
Keterangan
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 | Esscli.dll; Fastprox.dll; FrameDyn.dll; FrameDynOS.dll; Wbemcomn.dll; Wbemcore.dll; Wbemess.dll; Wmipjobj.dll |