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.

O exemplo a seguir mostra como cancelar uma chamada assíncrona.

objwbemsink.Cancel()
set objwbemsink= Nothing

Requisitos

Confira também

SWbemSink