Método SWbemObject.DeleteAsync_

O método DeleteAsync_ do SWbemObject exclui de maneira assíncrona a classe atual ou a instância atual. Se um provedor dinâmico fornece a classe ou instância, pode ser impossível excluir esse objeto, a menos que o provedor dê suporte à exclusão da classe ou instância.

Para ver uma explicação dessa sintaxe, confira Convenções de documento para a API de script.

Sintaxe

SWbemObject.DeleteAsync_( _
  ByVal objWbemSink, _
  [ ByVal iFlags ], _
  [ ByVal objwbemNamedValueSet ], _
  [ ByVal objWbemAsyncContext ] _
)

Parâmetros

objWbemSink [entrada]

Coletor de objetos que retorna o resultado da operação de exclusão.

iFlags [entrada, opcional]

Inteiro que determina o comportamento da chamada. 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 SWbemSink.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 [entrada, opcional]

Esse parâmetro normalmente é 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 [entrada, opcional]

Este é 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 essa chamada for bem-sucedida, o resultado da operação de exclusão será fornecido por meio do coletor de objetos fornecido.

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.

wbemErrAccessDenied – 2147749891 (0x80041003)

O contexto atual não tem direitos de segurança adequados para excluir o objeto.

wbemErrFailed – 2147749890 (0x80041002)

Erro não especificado.

wbemErrInvalidClass – 2147749904 (0x80041010)

A classe especificada não existe.

wbemErrInvalidOperation – 2147749910 (0x80041016)

O objeto não pode ser excluído.

wbemErrNotFound – 2147749890 (0x80041002)

O objeto não existia.

wbemErrOutOfMemory – 2147749894 (0x80041006)

Não há memória suficiente para concluir a operação.

Comentários

Essa chamada é retornada imediatamente. O status é retornado ao chamador por meio de um retorno de chamada entregue ao coletor especificado em objWbemSink.

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 comunicação semissíncrona ou síncrona. Para obter mais informações, consulte Chamar um método.

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_SWbemObject
IID	IID_ISWbemObject