Método IWbemServices::D eleteClass (wbemcli.h)
O método IWbemServices::D eleteClass exclui a classe especificada do namespace atual. Se um provedor de instância dinâmica estiver associado à classe , o provedor não será registrado e não será mais chamado por 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 um provedor de classe dinâmica fornecer a classe , o sucesso da exclusão dependerá se o provedor oferecer suporte à exclusão de classe.
Sintaxe
HRESULT DeleteClass(
[in] const BSTR strClass,
[in] long lFlags,
[in] IWbemContext *pCtx,
[out] IWbemCallResult **ppCallResult
);
Parâmetros
[in] strClass
Nome da classe direcionada para exclusão.
[in] lFlags
Um dos valores a seguir pode ser definido.
WBEM_FLAG_RETURN_IMMEDIATELY
Esse sinalizador faz com que essa seja uma chamada semissíncrona. Para obter mais informações, confira Como chamar um método.
WBEM_FLAG_OWNER_UPDATE
Indica que o chamador é um provedor de push.
[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.
[out] ppCallResult
Se FOR NULL, esse parâmetro não será usado. Se ppCallResult for especificado, ele deverá ser definido para apontar para NULL na entrada. Se o parâmetro lFlags contiver WBEM_FLAG_RETURN_IMMEDIATELY, essa chamada retornará imediatamente com WBEM_S_NO_ERROR. O parâmetro ppCallResult recebe um ponteiro para um novo objeto IWbemCallResult , que pode ser sondado para obter o resultado usando o método GetCallStatus .
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.
Em caso de falha, você pode obter todas as informações disponíveis da função COM GetErrorInfo.
Códigos de erro específicos do 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.
Requisitos
| Requisito | Valor |
|---|---|
| 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 |