Метод ISWbemSink::Cancel

  • Статья

Метод Cancel объекта SWbemSink отменяет все невыполненные асинхронные операции, связанные с этим приемником объектов.

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

Синтаксис

SWbemSink.Cancel()

Параметры

Этот метод не имеет параметров.

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

Этот метод не возвращает значение.

Коды ошибок

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

wbemErrFailed — 2147749889 (0x80041001)

Незаданная ошибка.

wbemErrOutOfMemory — 2147749894 (0x80041006)

Недостаточно памяти для завершения операции.

wbemErrTransportFailure — 2147749909 (0x80041015)

Произошла ошибка сети, препятствующая нормальной работе.

wbemErrAccessDenied — 2147749891 (0x80041003)

Текущее или указанное имя пользователя и пароль не являются допустимыми или не авторизованы для подключения.

Комментарии

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

Вы не можете назначить этому приемнику значение Nothing для отмены асинхронной операции. Необходимо вызвать метод Cancel , чтобы WMI прекратил операцию и освободил связанные ресурсы. Это очень важно для длительных асинхронных операций, таких как запросы, или операций, которые никогда не завершались, например ExecNotificationQueryAsync.

Примечание

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

В следующем примере показано, как отменить асинхронный вызов.

objwbemsink.Cancel()
set objwbemsink= Nothing

Требования

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

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

SWbemSink