Функция QualifierSet_Next

Получает следующий квалификатор в перечислении, начатом вызовом функции QualifierSet_BeginEnumeration.

Примечание

Этот интерфейс API предназначен только для внутреннего использования. Он не предназначен для использования из кода разработчика.

Синтаксис

HRESULT QualifierSet_Next (
   [in] int                  vFunc,
   [in] IWbemQualifierSet*   ptr,
   [in] LONG                 lFlags,
   [out] BSTR*               pstrName,
   [out] VARIANT*            pVal,
   [out] LONG*               plFlavor
);

Параметры

vFunc [in] Этот параметр не используется.

ptr [in] Указатель на экземпляр IWbemQualifierSet .

lFlags [in] Защищены. Этот параметр должен иметь значение 0.

pstrName [out] Имя квалификатора. Если nullзадано значение , этот параметр игнорируется; pstrName в противном случае не должно указывать на допустимое BSTR значение или происходит утечка памяти. Если значение не равно NULL, функция всегда выделяет новый BSTR объект при возврате WBEM_S_NO_ERROR.

pVal [out] При успешном выполнении — значение квалификатора. Если функция завершается сбоем, объект , VARIANT на который pVal указывает , не изменяется. Если этот параметр имеет значение null, параметр игнорируется.

plFlavor [out] Указатель на long, получающий вкус квалификатора. Если сведения о вкусе не нужны, этот параметр может иметь значение null.

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

Следующие значения, возвращаемые этой функцией, определяются в файле заголовка WbemCli.h или их можно определить как константы в коде:

Константа Значение Описание
WBEM_E_INVALID_PARAMETER 0x80041008 Недействительный параметр.
WBEM_E_UNEXPECTED 0x8004101d Вызывающий объект не вызывал QualifierSet_BeginEnumeration.
WBEM_E_OUT_OF_MEMORY 0x80041006 Недостаточно памяти для начала нового перечисления.
WBEM_S_NO_MORE_DATA 0x40005 В перечислении больше не осталось квалификаторов.
WBEM_S_NO_ERROR 0 Вызов функции выполнен успешно.

Комментарии

Эта функция заключает в оболочку вызов метода IWbemQualifierSet::Next .

Вы вызываете функцию QualifierSet_Next несколько раз для перечисления всех квалификаторов, пока функция не вернет WBEM_S_NO_MORE_DATA. Чтобы завершить перечисление раньше, вызовите функцию QualifierSet_EndEnumeration .

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

Требования

Платформы: см. раздел Требования к системе.

Заголовка: WMINet_Utils.idl

платформа .NET Framework версии: доступно с версии 4.7.2.

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

  • Last updated on