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

Функция BeginEnumeration

  • Статья

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

Примечание

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

Синтаксис

HRESULT BeginEnumeration (
   [in] int               vFunc,
   [in] IWbemClassObject* ptr,
   [in] LONG              lEnumFlags
);

Параметры

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

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

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

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

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

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

Комментарии

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

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

Группа 1

Константа Значение Описание
WBEM_FLAG_KEYS_ONLY 0x4 Включите свойства, которые составляют только ключ.
WBEM_FLAG_REFS_ONLY 0x8 Включите свойства, которые являются только ссылками на объекты.

Группа 2

Константа Значение Описание
WBEM_FLAG_SYSTEM_ONLY 0x30 Ограничьте перечисление только системным свойством.
WBEM_FLAG_NONSYSTEM_ONLY 0x40 Включите локальные и распространяемые свойства, но исключите системные свойства из перечисления.

Для классов:

Константа Значение Описание
WBEM_FLAG_CLASS_OVERRIDES_ONLY 0x100 Ограничьте перечисление свойствами, переопределенным в определении класса.
WBEM_FLAG_CLASS_LOCAL_AND_OVERRIDES 0x100 Ограничьте перечисление свойствами, переопределенным в текущем определении класса, и новыми свойствами, определенными в классе .
WBEM_MASK_CLASS_CONDITION 0x300 Маска (а не флаг), применяемая lEnumFlags к значению для проверка, если задано значение WBEM_FLAG_CLASS_OVERRIDES_ONLY или WBEM_FLAG_CLASS_LOCAL_AND_OVERRIDES .
WBEM_FLAG_LOCAL_ONLY 0x10 Ограничьте перечисление свойствами, которые определены или изменены в самом классе.
WBEM_FLAG_PROPAGATED_ONLY 0x20 Ограничьте перечисление свойствами, унаследованными от базовых классов.

Для экземпляров:

Константа Значение Описание
WBEM_FLAG_LOCAL_ONLY 0x10 Ограничьте перечисление свойствами, которые определены или изменены в самом классе.
WBEM_FLAG_PROPAGATED_ONLY 0x20 Ограничьте перечисление свойствами, унаследованными от базовых классов.

Требования

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

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

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

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