Метод 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 |
Заголовок |
|
IDL |
|
DLL |
|
CLSID |
CLSID_SWbemSink |
IID |
IID_ISWbemSink |