Метод SWbemServices.GetAsync

Статья
06/13/2023

Метод GetAsync объекта SWbemServices извлекает объект, который является определением класса или экземпляром, на основе пути к объекту.

Этот метод извлекает только объекты из пространства имен, связанного с текущим объектом SWbemServices .

Этот метод вызывается в асинхронном режиме. Дополнительные сведения см. в разделе Вызов метода.

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

Синтаксис

SWbemServices.GetAsync( _
  ByVal objWbemSink, _
  [ ByVal strObjectPath ], _
  [ ByVal iFlags ], _
  [ ByVal objwbemNamedValueSet ], _
  [ ByVal objWbemAsyncContext ] _
)

Параметры

objWbemSink: Обязательный. Приемник объектов, который получает объекты асинхронно. Создайте объект SWbemSink для получения объектов .
strObjectPath [необязательно]: Путь к объекту, который требуется извлечь. Если это значение пусто, возвращаемый пустой объект может стать новым классом. Дополнительные сведения см. в разделе Описание расположения объекта WMI.
iFlags [необязательно]: Целое число, определяющее поведение вызова. Этот параметр может принимать следующие значения.
wbemFlagSendStatus (128 (0x80)): Вызывает асинхронные вызовы для отправки обновлений состояния в обработчик событий OnProgress для приемника объекта.
wbemFlagDontSendStatus (0 (0x0)): Запрещает асинхронным вызовам отправлять обновления состояния в обработчик событий OnProgress для приемника объектов.
wbemFlagUseAmendedQualifiers (131072 (0x20000)): Заставляет WMI возвращать данные изменения класса с определением базового класса. Дополнительные сведения см. в разделе Локализация сведений о классе WMI.

objwbemNamedValueSet [необязательно]

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

objWbemAsyncContext [необязательно]

Объект SWbemNamedValueSet , который возвращается в приемник объекта для идентификации источника исходного асинхронного вызова. Используйте этот параметр, если выполняете несколько асинхронных вызовов с использованием одного и того же приемника объектов. Чтобы использовать этот параметр, создайте объект SWbemNamedValueSet и используйте метод SWbemNamedValueSet.Add , чтобы добавить значение, определяющее асинхронный вызов, который вы выполняете. Этот объект SWbemNamedValueSet возвращается в приемник объекта, а источник вызова можно извлечь с помощью метода SWbemNamedValueSet.Item . Дополнительные сведения см. в разделе Вызов метода.

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

Этот метод не возвращает значение. В случае успешного выполнения приемник получает событие OnObjectReady , когда объект доступен.

Коды ошибок

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

wbemErrAccessDenied — 2147749891 (0x80041003): Текущий пользователь не имеет разрешения на доступ к объекту .
wbemErrFailed — 2147749889 (0x80041001): Незаданная ошибка.
wbemErrInvalidParameter — 2147749896 (0x80041008): Указанный параметр недопустим.
wbemErrInvalidObjectPath — 2147749946 (0x8004103A): Указанный путь недопустим.
wbemErrNotFound — 2147749890 (0x80041002): Не удалось найти запрошенный объект.
wbemErrOutOfMemory — 2147749894 (0x80041006): Недостаточно памяти для завершения операции.

Этот вызов возвращается немедленно. Запрошенный объект и состояние возвращаются вызывающей объекту через обратный вызов, доставляемый в приемник, указанный в objWbemSink. Чтобы обработать объект при его возврате, создайте objWbemSink. OnObjectReady или objWbemSink. Подпрограмма события OnCompleted .

Асинхронный обратный вызов позволяет пользователю, не прошедшему проверку подлинности, предоставлять данные в приемник. Это создает угрозы безопасности для сценариев и приложений. Чтобы устранить риски, используйте полусинхронную или синхронную связь. Дополнительные сведения см. в разделе Настройка безопасности при асинхронном вызове.

Требования

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

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

SWbemServices
SWbemObject

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