Método ISWbemSink::Cancel
O método Cancel do objeto SWbemSink cancela todas as operações assíncronas pendentes associadas a esse coletor de objetos.
Para obter uma explicação dessa sintaxe, confira Convenções de documentação para a API de Script.
Sintaxe
SWbemSink.Cancel()
Parâmetros
Esse método não tem parâmetros.
Retornar valor
Esse método não retorna um valor.
Códigos do Erro
Após a conclusão do método Cancel, o objeto Err poderá conter um dos códigos de erro abaixo.
-
wbemErrFailed - 2147749889 (0x80041001)
-
Erro não especificado.
-
wbemErrOutOfMemory – 2147749894 (0x80041006)
-
Não há memória suficiente para concluir a operação.
-
wbemErrTransportFailure – 2147749909 (0x80041015)
-
Erro de rede impedindo a operação normal.
-
wbemErrAccessDenied - 2147749891 (0x80041003)
-
O nome de usuário e a senha atuais ou especificados não são válidos ou autorizados a fazer a conexão.
Comentários
Não é possível cancelar apenas uma chamada assíncrona. Se estiverem pendentes várias chamadas assíncronas que usam esse coletor de objetos, esse método cancelará todas as chamadas assíncronas usando esse coletor de objetos. Chamadas assíncronas associadas a outros coletores de objetos não são afetadas.
Você não pode atribuir esse coletor a Nada para cancelar uma operação assíncrona. Você precisa chamar o método Cancel para fazer o WMI descontinuar a operação e liberar os recursos associados. Isso é muito importante com operações assíncronas longas, como consultas, ou operações que nunca são concluídas, como ExecNotificationQueryAsync.
Observação
Um retorno de chamada assíncrono permite que um usuário não autenticado forneça dados ao coletor. Isso representa riscos de segurança para seus scripts e aplicativos. Para eliminar os riscos, use a comunicação semissíncrona ou síncrona. Para obter mais informações, consulte Chamar um método.
O exemplo a seguir mostra como cancelar uma chamada assíncrona.
objwbemsink.Cancel()
set objwbemsink= Nothing
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows Vista |
| Servidor mínimo com suporte |
Windows Server 2008 |
| Cabeçalho |
|
| IDL |
|
| DLL |
|
| CLSID |
CLSID_SWbemSink |
| IID |
IID_ISWbemSink |