Событие ISWbemSinkEvents::OnCompleted
Событие OnCompleted объекта SWbemSink активируется при завершении асинхронного вызова. Это событие указывает клиентскому приложению на результат асинхронной операции и предоставляет сведения об ошибке при сбое асинхронного вызова.
Описание этого синтаксиса см. в разделе Соглашения о документах для API сценариев.
Синтаксис
SWbemSink.OnCompleted( _
ByVal iHResult, _
ByVal objWbemErrorObject, _
ByVal objWbemAsyncContext _
)
Параметры
-
iHResult
-
HRESULT завершенного асинхронного метода. HRESULT совпадает со значением, возвращаемым из эквивалентного COM API для вызова метода WMI . Проверьте это значение, чтобы определить, успешно ли выполнен асинхронный вызов. Если асинхронный вызов выполнен успешно, этот параметр содержит WBEM_S_NO_ERROR (0). Если асинхронный вызов завершается сбоем, этот параметр содержит код ошибки.
-
objWbemErrorObject
-
Содержит объект SWbemLastError при сбое асинхронного метода.
-
objWbemAsyncContext
-
Это объект SWbemNamedValueSet , который передается в исходный асинхронный вызов. Используйте этот параметр, чтобы определить источник асинхронного вызова, который активирует это событие при выполнении нескольких асинхронных вызовов с помощью этого приемника объекта.
Возвращаемое значение
Это событие не возвращает значение.
Коды ошибок
После завершения события OnCompleted объект Err может содержать один из приведенных ниже кодов ошибок.
-
wbemErrFailed — 2147749889 (0x80041001)
-
Незаданная ошибка.
-
wbemErrOutOfMemory — 2147749894 (0x80041006)
-
Недостаточно памяти для завершения операции.
-
wbemErrTransportFailure — 2147749909 (0x80041015)
-
Произошла ошибка сети, препятствующая нормальной работе.
Комментарии
Асинхронный обратный вызов позволяет пользователю, не прошедшему проверку подлинности, предоставлять данные в приемник. Это создает угрозу безопасности для сценариев и приложений. Чтобы избежать рисков, используйте полусинхронную или синхронную связь. Дополнительные сведения см. в разделе Вызов метода .
Требования
Требование | Значение |
---|---|
Минимальная версия клиента |
Windows Vista |
Минимальная версия сервера |
Windows Server 2008 |
Заголовок |
|
IDL |
|
DLL |
|
CLSID |
CLSID_SWbemSink |
IID |
IID_ISWbemSinkEvents |