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	Wbemdisp.h
IDL	Wbemdisp.idl
DLL	Wbemdisp.dll
CLSID	CLSID_SWbemSink
IID	IID_ISWbemSink

Confira também

SWbemSink