Метод SWbemObject.Subclasses_

Статья
06/13/2023

Метод Subclasses_ объекта SWbemObject возвращает объект SWbemObjectSet . Этот объект представляет собой коллекцию подклассов текущего объекта , который должен быть классом . Элементы в возвращаемой коллекции можно получить с помощью стандартных методов сбора. Дополнительные сведения см. в разделе Доступ к коллекции.

Описание этого синтаксиса см. в разделе Соглашения о документах для API скриптов.

Синтаксис

objWbemObjectSet = .Subclasses_( _
  [ ByVal iFlags ], _
  [ ByVal objwbemNamedValueSet ] _
)

Параметры

iFlags [in, необязательный]: Целое число, определяющее детализацию перечисления вызова. Этот параметр может принимать следующие значения.
wbemQueryFlagDeep (0 (0x0)): Принудительное рекурсивное перечисление во все подклассы, производные от указанного родительского класса. Сам родительский класс не возвращается в перечислении .
wbemQueryFlagShallow (1 (0x1)): Значение по умолчанию для этого параметра. Он заставляет перечисление включать только непосредственные подклассы указанного родительского класса.
WbemFlagReturnImmediately (16 (0x10)): Вызывает немедленный возврат вызова
wbemFlagReturnWhenComplete (0 (0x0)): Вызывает блокировку этого вызова до завершения вызова.
wbemFlagUseAmendedQualifiers (131072 (0x20000)): Заставляет WMI возвращать данные изменения класса вместе с определением базового класса.

objwbemNamedValueSet [in, необязательный]

Как правило, это не определено. В противном случае это объект SWbemNamedValueSet , элементы которого представляют сведения контекста, которые могут использоваться поставщиком, обслуживающим запрос. Поставщик, который поддерживает или требует такие сведения, должен документировать имена распознаваемых значений, тип данных значения, допустимые значения и семантику.

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

Если вызов выполнен успешно, возвращается объект SWbemObjectSet .

Коды ошибок

После завершения метода Subclasses_ объект Err может содержать один из кодов ошибок в следующем списке.

wbemErrAccessDenied — 2147749891 (0x80041003): Текущий пользователь не имеет разрешения на просмотр одного или нескольких классов, возвращенных вызовом.
wbemErrFailed — 2147749889 (0x80041001): Незаданная ошибка.
wbemErrInvalidClass — 2147749904 (0x80041010): Указанный класс не существует.
wbemErrInvalidParameter — 2147749896 (0x80041008): Указан недопустимый параметр.
wbemErrOutOfMemory — 2147749894 (0x80041006): Недостаточно памяти для завершения операции.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista
Минимальная версия сервера	Windows Server 2008
Заголовок	Wbemdisp.h
Библиотека типов	Wbemdisp.tlb
DLL	Wbemdisp.dll
CLSID	CLSID_SWbemObject
IID	IID_ISWbemObject

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

SWbemObject
SWbemObjectSet

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