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

Статья
08/27/2023

Метод IWbemContext::Next извлекает следующее значение в перечислении всех значений контекста, начиная с IWbemContext::BeginEnumeration.

Синтаксис

HRESULT Next(
  [in]  long    lFlags,
  [out] BSTR    *pstrName,
  [out] VARIANT *pValue
);

Параметры

[in] lFlags

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

[out] pstrName

Этот параметр не может иметь значение NULL. Указатель не должен указывать на активную запись BSTR , и в идеале он должен иметь значение NULL. Если код ошибки не возвращается, он указывает на только что выделенную строку BSTR , содержащую имя значения контекста.

Вызывающий объект должен вызывать SysFreeString для возвращаемой строки, если она больше не требуется. Если WBEM_S_NO_MORE_DATA возвращает значение , для параметра pstrName задано значение NULL, и в этом случае не следует вызывать SysFreeString . Обратите внимание, что если pstrName указывает на допустимую запись BSTR , эта строка BSTR не освобождается и происходит утечка памяти.

[out] pValue

Этот параметр не может иметь значение NULL и должен указывать на пустой или неинициализированный вариант VARIANT. Если ошибка не возвращается, variant инициализируется с помощью VariantInit, а затем устанавливается значение , содержащее значение контекста. Вызывающий объект должен вызывать VariantClear для этого указателя, если значение больше не требуется. Если возвращается код ошибки, значение VARIANT , на которое указывает pValue, остается без изменений.

Если WBEM_S_NO_MORE_DATA возвращает значение , этот параметр указывает на VARIANT типа VT_NULL.

Возможно, внутри VARIANT может быть возвращен весь объект IWbemClassObject. В этом случае VT_UNKNOWN — это тип VARIANT . Вызывающий объект может принять указатель IUnknown и выполнить QueryInterface , чтобы получить указатель IWbemClassObject .

Примечание В конце перечисления возвращается WBEM_S_NO_MORE_DATA . Возвращаемый вариант VARIANT имеет тип VT_NULL, а возвращаемое значение pstrName равно NULL.

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

Этот метод возвращает 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::EndEnumeration

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