Функция 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.
См. также раздел
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по