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

Статья
08/27/2023

Метод 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.

Требования


Минимальная версия клиента	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