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

Функция QualifierSet_BeginEnumeration

  • Статья

Сбрасывает перечислитель квалификаторов объекта в начало перечисления.

Примечание

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

Синтаксис

HRESULT QualifierSet_BeginEnumeration (
   [in] int                  vFunc,
   [in] IWbemQualifierSet*   ptr,
   [in] LONG                 lFlags
);

Параметры

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

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

lFlags
[in] Побитовое сочетание флагов или значений, описанных в разделе Примечания , которое указывает квалификаторы для включения в перечисление.

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

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

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

Комментарии

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

Чтобы перечислить все квалификаторы объекта, этот метод необходимо вызвать до первого вызова QualifierSet_Next. Порядок перечисления квалификаторов гарантированно будет инвариантным для данного перечисления.

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

Константа Значение Описание
0 Возвращает имена всех квалификаторов.
WBEM_FLAG_LOCAL_ONLY 0x10 Возвращает только имена квалификаторов, относящихся к текущему свойству или объекту.
Для свойства: возвращает только квалификаторы, относящиеся к свойству (включая переопределения), а не квалификаторы, распространяемые из определения класса.
Для экземпляра: возвращает только имена квалификатора для конкретного экземпляра.
Для класса: возвращает только квалификаторы, относящиеся к производимому классу.
WBEM_FLAG_PROPAGATED_ONLY 0x20 Возвращает только имена квалификаторов, распространяемых из другого объекта.
Для свойства: возвращает только квалификаторы, распространяются на это свойство из определения класса, а не из самого свойства.
Для экземпляра: возвращает только те квалификаторы, которые распространяются из определения класса.
Для класса: возвращает только те имена квалификатора, наследуемые от родительских классов.

Требования

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

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

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

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