Метод IWbemPathKeyList::GetKey (wmiutils.h)
Метод IWbemPathKeyList::GetKey извлекает имя или значение ключа. Ключи индексируются от 0 (нуля), хотя порядок ключей незначим.
Синтаксис
HRESULT GetKey(
[in] ULONG uKeyIx,
[in] ULONG uFlags,
[in, out] ULONG *puNameBufSize,
[in, out] LPWSTR pszKeyName,
[in, out] ULONG *puKeyValBufSize,
[in, out] LPVOID pKeyVal,
[in, out] ULONG *puApparentCimType
);
Параметры
[in] uKeyIx
Индекс ключа, начиная с 0 (нуль).
[in] uFlags
Зарезервировано. Значение должно быть равно 0 (ноль).
[in, out] puNameBufSize
Вызывающий объект задает количество символов, которое может содержать буфер имен. При успешном выполнении задается количество символов, скопированных в буфер, включая завершающее значение NULL.
[in, out] pszKeyName
Буфер, в который копируется имя. Так как не все ключи имеют имя, этот параметр будет иметь значение NULL для неявного ключа.
[in, out] puKeyValBufSize
Вызывающий объект задает количество символов, которое может содержать буфер значений. При успешном выполнении устанавливается количество символов, скопированных в буфер, включая признак конца NULL .
[in, out] pKeyVal
Буфер, в который копируются данные.
[in, out] puApparentCimType
Указатель на объект long, для которого задан тип CIM.
Возвращаемое значение
Этот метод возвращает HRESULT , указывающий состояние вызова метода.
Комментарии
Рекомендуется определить, насколько большой требуется буфер, вызвав этот метод, передав указатель NULL для буфера и установив для его параметра size значение 0 (ноль). После возврата параметр size буфера указывает, насколько большой размер буфера необходим для строки и ее конца NULL . Затем можно вызвать метод , чтобы получить значение буфера.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows Vista |
| Минимальная версия сервера | Windows Server 2008 |
| Целевая платформа | Windows |
| Header | wmiutils.h |
| Библиотека | Wbemuuid.lib |
| DLL | Wmiutils.dll |