Metode IWbemPathKeyList::GetKey2 (wmiutils.h)

Metode IWbemPathKeyList::GetKey2 mengambil nama atau nilai kunci, dan mengembalikan nilai sebagai VARIAN. Kunci diindeks dari 0 (nol), tetapi urutan kunci tidak signifikan.

Sintaks

HRESULT GetKey2(
  [in]      ULONG   uKeyIx,
  [in]      ULONG   uFlags,
  [in, out] ULONG   *puNameBufSize,
  [out]     LPWSTR  pszKeyName,
  [out]     VARIANT *pKeyValue,
  [out]     ULONG   *puApparentCimType
);

Parameter

[in] uKeyIx

Indeks kunci dimulai pada 0 (nol).

[in] uFlags

Dicadangkan. Harus 0 (nol).

[in, out] puNameBufSize

Pemanggil mengatur parameter ini ke jumlah karakter yang dapat ditahan oleh buffer nama. Jika berhasil, ini diatur ke jumlah karakter yang disalin ke dalam buffer—termasuk NULL yang mengakhiri.

[out] pszKeyName

Buffer tempat nama disalin. Karena tidak semua kunci memiliki nama, nilai parameter ini ADALAH NULL untuk kunci implisit.

[out] pKeyValue

Penunjuk ke varian yang berisi nilai kunci.

[out] puApparentCimType

Penunjuk ke bilangan bulat panjang yang diatur ke jenis CIM.

Mengembalikan nilai

Metode ini mengembalikan HRESULT yang menunjukkan status panggilan metode.

Keterangan

Metode ini dapat digunakan untuk menentukan seberapa besar buffer yang diperlukan dengan meneruskan pointer NULL untuk buffer dan mengatur parameter ukurannya menjadi 0 (nol). Ketika dikembalikan, parameter ukuran buffer menunjukkan buffer ukuran yang diperlukan untuk string dan terminator NULL-nya .

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista
Server minimum yang didukung	Windows Server 2008
Target Platform	Windows
Header	wmiutils.h
Pustaka	Wbemuuid.lib
DLL	Wmiutils.dll

Lihat juga

IWbemPath

IWbemPathKeyList

IWbemPathKeyList::GetKey