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

Статья
08/27/2023

Метод IWbemQualifierSet::Next извлекает следующий квалификатор в перечислении, которое началось с IWbemQualifierSet::BeginEnumeration. Этот метод вызывается повторно для перечисления всех квалификаторов до тех пор, пока не возвращается WBEM_S_NO_MORE_DATA . Чтобы завершить перечисление раньше, вызовите IWbemQualifierSet::EndEnumeration.

Порядок квалификаторов, возвращаемых во время перечисления, не определен.

Синтаксис

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

Параметры

[in] lFlags

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

[out] pstrName

Этот параметр получает имя квалификатора. При возврате WBEM_S_NO_ERROR всегда выделяется новая строка BSTR.

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

[out] pVal

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

[out] plFlavor

Если значение не равно NULL, для значения, указываемого на , задается вкус квалификатора. Дополнительные сведения см. в разделе Варианты квалификатора и WBEM_FLAVOR_TYPE.

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

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

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista
Минимальная версия сервера	Windows Server 2008
Целевая платформа	Windows
Header	wbemcli.h (включая Wbemidl.h)
Библиотека	Wbemuuid.lib
DLL	Fastprox.dll; Krnlprov.dll; Ncprov.dll; Wbemcore.dll

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

IWbemQualifierSet::BeginEnumeration

IWbemQualifierSet::EndEnumeration

Варианты квалификатора

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