Событие ISWbemSinkEvents::OnProgress

Статья
06/13/2023

Событие OnProgressSWbemSink активируется, когда асинхронный вызов возвращает состояние текущего вызова. Если события, экземпляры или классы создаются от поставщика, поддерживающего обновления состояния, в это событие можно поместить код, чтобы предоставить пользователям отзывы о состоянии асинхронной операции. Чтобы получать обновления состояния, необходимо задать параметр iFlags асинхронного вызова wbemFlagSendStatus (128/0x80), в противном случае это событие не активируется.

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

Синтаксис

SWbemSink.OnProgress( _
  ByVal iUpperBound, _
  ByVal iCurrent, _
  ByVal strMessage, _
  ByVal objWbemAsyncContext _
)

Параметры

iUpperBound: Целое число, описывающее общее количество задач для выполнения.
iCurrent: Текущий элемент, который обрабатывается.
strMessage: Сообщение, описывающее состояние текущей задачи.
objWbemAsyncContext: Объект SWbemNamedValueSet , передаваемый в исходный асинхронный вызов. Используйте этот параметр, чтобы определить источник асинхронного вызова, который активирует это событие при выполнении нескольких асинхронных вызовов с помощью этого приемника объекта.

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

Это событие не возвращает значение.

Коды ошибок

После завершения события OnProgress объект Err может содержать один из приведенных ниже кодов ошибок.

wbemErrFailed — 2147749889 (0x80041001): Незаданная ошибка.
wbemErrOutOfMemory — 2147749894 (0x80041006): Недостаточно памяти для завершения операции.
wbemErrTransportFailure — 2147749909 (0x80041015): Произошла ошибка сети, препятствующая нормальной работе.

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

Примечание

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

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista
Минимальная версия сервера	Windows Server 2008
Заголовок	Wbemdisp.h
IDL	Wbemdisp.idl
DLL	Wbemdisp.dll
CLSID	CLSID_SWbemSink
IID	IID_ISWbemSinkEvents

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

SWbemSink

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