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

  • Artigo

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.

Nota As classes do sistema não podem ser excluídas.
 

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

Confira também

IWbemServices

IWbemServices::D eleteClassAsync

Como recuperar um código de erro