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


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

Метод 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 (включая 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