Metode IWbemContext::GetNames (wbemcli.h)

Artikel
08/27/2023

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.

Catatan Jika tidak ada nilai bernama dalam objek, panggilan berhasil dan mengembalikan array dengan panjang 0.

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

Lihat juga

IWbemContext

IWbemContext::BeginEnumeration

IWbemContext::GetValue

Bagikan melalui