Метод SWbemObject.Instances_

Статья
06/13/2023

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

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

Синтаксис

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

Параметры

iFlags [in, необязательный]: Целое число, определяющее поведение вызова. Этот параметр может принимать следующие значения.
wbemFlagForwardOnly (32 (0x20)): Возвращает перечислитель только для прямого доступа. Перечислители только вперед обычно выполняются гораздо быстрее и используют меньше памяти, чем обычные перечислители, но не разрешают вызовы SWbemObject.Clone_.
wbemFlagBidirectional (0 (0x0)): Заставляет WMI сохранять указатели на объекты перечисления до тех пор, пока клиент не отпустит перечислитель.
wbemFlagReturnImmediately (16 (0x10)): Значение по умолчанию для этого параметра. Этот флаг приводит к немедленному возврату вызова.
wbemFlagReturnWhenComplete ( 0 (0x0)): Вызывает блокировку этого вызова до завершения запроса.
wbemQueryFlagShallow (1 (0x1)): Принудительное включение перечисления только непосредственных подклассов указанного родительского класса.
wbemQueryFlagDeep (0 (0x0)): Значение по умолчанию для этого параметра. Это значение заставляет перечисление включать все классы в иерархию.
wbemFlagUseAmendedQualifiers (131072 (0x20000)): Заставляет WMI возвращать данные о поправках класса с определением базового класса.

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

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

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

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

Коды ошибок

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

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

Метод Instances_ работает только для объектов класса. Возвращаемая коллекция не является ошибкой, если в ней нет элементов. Поведение по умолчанию для этого метода является полусинхронным из-за значения по умолчанию IFlagswbemFlagReturnImmediately.

Требования

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

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

SWbemObject
SWbemObjectSet