Поделиться через


Метод IWbemPathKeyList::GetKey2 (wmiutils.h)

Метод IWbemPathKeyList::GetKey2 извлекает имя или значение ключа и возвращает значение в виде VARIANT. Ключ индексируется от 0 (ноль), но порядок ключей не имеет значения.

Синтаксис

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

Параметры

[in] uKeyIx

Индекс ключа начинается с 0 (ноль).

[in] uFlags

Зарезервировано. Должно быть равно 0 (ноль).

[in, out] puNameBufSize

Вызывающий объект задает для этого параметра количество символов, которое может содержать буфер имен. При успешном выполнении задается количество символов, копируемых в буфер, включая завершающее значение NULL.

[out] pszKeyName

Буфер, в который копируется имя. Так как не все ключи имеют имя, этот параметр имеет значение NULL для неявного ключа.

[out] pKeyValue

Указатель на вариант, содержащий значение ключа.

[out] puApparentCimType

Указатель на длинное целое число, задающее тип CIM.

Возвращаемое значение

Этот метод возвращает HRESULT , указывающий состояние вызова метода.

Комментарии

Этот метод можно использовать для определения размера буфера путем передачи указателя NULL для буфера и задания его параметра размера равным 0 (нолю). При возврате параметр buffer size указывает буфер размера, необходимый для строки, и ее признак конца NULL .

Требования

Требование Значение
Минимальная версия клиента Windows Vista
Минимальная версия сервера Windows Server 2008
Целевая платформа Windows
Header wmiutils.h
Библиотека Wbemuuid.lib
DLL Wmiutils.dll

См. также раздел

IWbemPath

IWbemPathKeyList

IWbemPathKeyList::GetKey