Метод IWbemContext::GetNames (wbemcli.h)

  • Статья
  • Чтение занимает 2 мин

Метод IWbemContext::GetNames возвращает структуру SAFEARRAY всех имен имен именованных значений контекста. После того как все имена известны, GetValue можно вызвать для каждого имени, чтобы получить значение. Этот метод представляет собой способ доступа к значениям контекста, отличающимся от вызова методов BeginEnumeration, Next и EndEnumeration .

Синтаксис

HRESULT GetNames(
  [in]  long      lFlags,
  [out] SAFEARRAY **pNames
);

Параметры

[in] lFlags

Зарезервировано. Этот параметр должен иметь значение 0.

[out] pNames

Этот параметр не может иметь значение NULL, но при записи он должен указывать на NULL. Если ошибка не возвращается, при выходе pstrNames получает указатель на новую структуру SAFEARRAY типа VT_BSTR, содержащую все имена значений контекста. Вызывающий объект должен вызвать SafeArrayDe с возвращенным указателем, если массив больше не требуется. Если возвращается код ошибки, указатель остается неизменен.

Примечание Если в объекте нет именованных значений, вызов завершается успешно и возвращает массив длиной 0.
 

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

Этот метод возвращает HRESULT , указывающее состояние вызова метода. В следующем списке перечислены значения, содержащиеся в HRESULT.

Комментарии

Дополнительные сведения об использовании структур SAFEARRAY значений BSTR см. в разделе "Извлечение части экземпляра WMI".

Требования

   
Минимальная версия клиента Windows Vista
Минимальная версия сервера Windows Server 2008
Целевая платформа Windows
Header wbemcli.h (include Wbemidl.h)
Библиотека Wbemuuid.lib
DLL Esscli.dll; Fastprox.dll; FrameDyn.dll; FrameDynOS.dll; Wbemcomn.dll; Wbemcore.dll; Wbemess.dll; Wmipjobj.dll

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

IWbemContext

IWbemContext::BeginEnumeration

IWbemContext::GetValue