Método IWbemServices::D eleteClassAsync (wbemcli.h)

  • Artigo

O método IWbemServices::D eleteClassAsync exclui a classe especificada do namespace atual. Esse método é idêntico a IWbemServices::D eleteClass, exceto pelo fato de que a chamada retorna imediatamente. A confirmação ou falha é relatada de forma assíncrona para o coletor de objeto especificado usando o método IWbemObjectSink::SetStatus após a conclusão da operação.

Sintaxe

HRESULT DeleteClassAsync(
  [in] const BSTR      strClass,
  [in] long            lFlags,
  [in] IWbemContext    *pCtx,
  [in] IWbemObjectSink *pResponseHandler
);

Parâmetros

[in] strClass

Nome da classe direcionada para exclusão.

[in] lFlags

Um ou mais dos valores a seguir são válidos.

WBEM_FLAG_SEND_STATUS

Esse sinalizador registra com o Gerenciamento do Windows uma solicitação para receber relatórios intermediários status por meio da implementação do cliente de IWbemObjectSink::SetStatus. A implementação do provedor deve dar suporte a relatórios de status intermediários para que esse sinalizador altere o comportamento.

WBEM_FLAG_OWNER_UPDATE

Os provedores de push devem especificar esse sinalizador ao chamar DeleteClassAsync para indicar que essa classe foi alterada.

[in] pCtx

Normalmente NULL. Caso contrário, esse é um ponteiro para um objeto IWbemContext que pode ser usado pelo provedor que exclui a classe. Os valores no objeto de contexto devem ser especificados na documentação do provedor em questão. Para obter mais informações sobre esse parâmetro, consulte Fazendo chamadas para WMI.

[in] pResponseHandler

Ponteiro para uma implementação de IWbemObjectSink implementada pelo chamador. Esse manipulador recebe a status da solicitação de exclusão quando ela fica disponível por meio do método IWbemObjectSink::SetStatus. Se algum código de erro for retornado, o ponteiro IWbemObjectSink fornecido não será usado. Se WBEM_S_NO_ERROR for retornado, a implementação IWbemObjectSink do usuário será chamada para indicar o resultado da operação. O Gerenciamento do Windows chama Somente AddRef no ponteiro nos casos em que WBEM_S_NO_ERROR retorna. Nos casos em que um código de erro retorna, a contagem de referência é a mesma que na entrada. Para obter uma explicação detalhada desse parâmetro, consulte Chamando um método.

Retornar valor

Esse método retorna um HRESULT que indica o status da chamada de método. A lista a seguir lista o valor contido em um HRESULT.

Todos os outros códigos de retorno são fornecidos ao coletor de objeto especificado pelo parâmetro pReponseHandler por meio do método SetStatus . Condições de erro, como quando a classe não existe ou o usuário não tem permissão para excluir classes, são relatadas ao manipulador. Eles não são relatados no código de retorno desse método.

Códigos de erro específicos de COM também poderão ser retornados se problemas de rede fizerem com que você perca a conexão remota com o Gerenciamento do Windows.

Comentários

Se um provedor de instância dinâmica estiver associado à classe , o provedor não será registrado e não será mais chamado para essa classe. Todas as classes derivadas da classe excluída também são excluídas e seus provedores associados não são registrados. Todas as instâncias estáticas pendentes da classe especificada e suas subclasses também são excluídas quando a classe é excluída.

Se a classe for fornecida por um provedor de classe dinâmica, o sucesso da exclusão dependerá se a exclusão de classe tem suporte desse provedor.

Nota Classes de sistema padrão não podem ser excluídas.
 
Como o retorno de chamada pode não ser retornado no mesmo nível de autenticação exigido pelo cliente, é recomendável que você use a comunicação semissíncrona em vez de assíncrona. Se você precisar de comunicação assíncrona, consulte Chamando um método.

Para obter mais informações sobre como usar métodos de forma semissíncrona, consulte IWbemServices::D eleteClass e Chamando um método.

Requisitos

   
Cliente mínimo com suporte Windows Vista
Servidor mínimo com suporte Windows Server 2008
Plataforma de Destino Windows
Cabeçalho wbemcli.h (include Wbemidl.h)
Biblioteca Wbemuuid.lib
DLL Fastprox.dll; Esscli.dll; FrameDyn.dll; FrameDynOS.dll; Ntevt.dll; Stdprov.dll; Viewprov.dll; Wbemcomn.dll; Wbemcore.dll; Wbemess.dll; Wbemsvc.dll; Wmipicmp.dll; Wmidcprv.dll; Wmipjobj.dll; Wmiprvsd.dll

Confira também

IWbemServices

IWbemServices::D eleteClass

Como recuperar um código de erro