Método IWbemServices::D eleteClassAsync (wbemcli.h)
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.
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 |