Partilhar via


Método SWbemServices.DeleteAsync

O método DeleteAsync do objeto SWbemServices exclui a classe ou instância especificada no caminho do objeto. A chamada para DeleteAsync é imediatamente retornada e os resultados e status são retornados ao chamador por meio de eventos entregues ao coletor especificado em objWbemSink. Para obter mais informações sobre como criar um coletor, consulte Receber um evento do WMI. Você só pode excluir objetos no namespace ao qual está conectado.

Se um provedor dinâmico fornecer a classe ou instância, às vezes não será possível excluir esse objeto, a menos que o provedor dê suporte à exclusão de classe ou instância.

O método é chamado no modo semissíncrono. Para obter mais informações, confira Como chamar um método.

Para conferir uma explicação dessa sintaxe, confira Convenções de documentação para API de script.

Sintaxe

SWbemServices.DeleteAsync( _
  [ ByVal ObjWbemSink ], _
  ByVal strObjectPath, _
  [ ByVal iFlags ], _
  [ ByVal objWbemNamedValueSet ], _
  [ ByVal objWbemAsyncContext ] _
)

Parâmetros

ObjWbemSink [opcional]

Coletor de objetos que recebe os resultados da exclusão. Crie um objeto SWbemSink para receber os objetos.

strObjectPath

Obrigatórios. Cadeia de caracteres que contém o caminho do objeto para o objeto que você deseja excluir. Para obter mais informações, consulte Descrever o local de um objeto do WMI.

iFlags [opcional]

Determina se atualizações de status são retornadas. Esse parâmetro pode aceitar os valores a seguir.

wbemFlagSendStatus (128 (0x80))

Faz com que chamadas assíncronas enviem atualizações de status ao manipulador de eventos OnProgress para o coletor de objetos.

wbemFlagDontSendStatus (0 (0x0))

Evita que chamadas assíncronas enviem atualizações de status ao manipulador de eventos OnProgress do coletor de objetos.

objWbemNamedValueSet [opcional]

Normalmente, isso é indefinido. Caso contrário, esse será um objeto SWbemNamedValueSet cujos elementos representam as informações de contexto que podem ser usadas pelo provedor que está atendendo à solicitação. Um provedor que dê suporte ou exija essas informações deve documentar os nomes de valor reconhecidos, o tipo de dados do valor, os valores permitidos e a semântica.

objWbemAsyncContext [opcional]

Um objeto SWbemNamedValueSet que é retornado ao coletor de objetos para identificar a origem da chamada assíncrona original. Use esse parâmetro se estiver fazendo várias chamadas assíncronas usando o mesmo coletor de objetos. Para usar esse parâmetro, crie um objeto SWbemNamedValueSet e use o método SWbemNamedValueSet.Add para adicionar um valor que identifique a chamada assíncrona que você está fazendo. Esse objeto SWbemNamedValueSet é retornado ao coletor de objeto, e a origem da chamada pode ser extraída usando o método SWbemNamedValueSet.Item. Para obter mais informações, confira Como chamar um método.

Retornar valor

Esse método não retorna um valor. Se a chamada for bem-sucedida, o coletor de objetos receberá uma notificação da exclusão.

Códigos do Erro

Após a conclusão do método DeleteAsync, o objeto Err poderá conter um dos códigos de erro da lista a seguir.

wbemErrFailed - 2147749889 (0x80041001)

Erro não especificado.

wbemErrInvalidParameter – 2147749896 (0x80041008)

Foi especificado um parâmetro inválido.

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.

wbemErrNotFound - 2147749890 (0x80041002)

O item solicitado não foi encontrado.

Comentários

Essa chamada é retornada imediatamente. O status da operação de exclusão é retornado ao chamador por meio de um retorno de chamada entregue ao coletor especificado em objWbemSink. Você pode executar o processamento final em sua implementação do evento objWbemSink.OnCompleted.

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, consulte Configurar a segurança em uma chamada assíncrona.

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows Vista
Servidor mínimo com suporte
Windows Server 2008
Cabeçalho
Wbemdisp.h
Biblioteca de tipos
Wbemdisp.tlb
DLL
Wbemdisp.dll
CLSID
CLSID_SWbemServices
IID
IID_ISWbemServices

Confira também

SWbemServices

SWbemObjectPath