Событие ISWbemSinkEvents::OnProgress

  • Статья

Событие 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