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

  • Artículo

El método IWbemServices::D eleteClass elimina la clase especificada del espacio de nombres actual. Si un proveedor de instancias dinámicas está asociado a la clase , el proveedor no se registra y ya no lo llama esa clase. Las clases que derivan de la clase eliminada también se eliminan y sus proveedores asociados no se registran. Todas las instancias estáticas pendientes de la clase especificada y sus subclases también se eliminan cuando se elimina la clase.

Si un proveedor de clases dinámicas proporciona la clase , el éxito de la eliminación depende de si el proveedor admite la eliminación de clases.

Nota No se pueden eliminar las clases del sistema.
 

Sintaxis

HRESULT DeleteClass(
  [in]  const BSTR      strClass,
  [in]  long            lFlags,
  [in]  IWbemContext    *pCtx,
  [out] IWbemCallResult **ppCallResult
);

Parámetros

[in] strClass

Nombre de la clase destinada a su eliminación.

[in] lFlags

Se puede establecer uno de los valores siguientes.

WBEM_FLAG_RETURN_IMMEDIATELY

Esta marca hace que sea una llamada semiincrónica. Para más información, vea Llamada a un método.

WBEM_FLAG_OWNER_UPDATE

Indica que el autor de la llamada es un proveedor de inserción.

[in] pCtx

Normalmente NULL. De lo contrario, se trata de un puntero a un objeto IWbemContext que el proveedor puede usar eliminando la clase . Los valores del objeto de contexto deben especificarse en la documentación del proveedor en cuestión. Para obtener más información sobre este parámetro, vea Realizar llamadas a WMI.

[out] ppCallResult

Si es NULL, no se usa este parámetro. Si se especifica ppCallResult , debe establecerse para que apunte a NULL en la entrada. Si el parámetro lFlags contiene WBEM_FLAG_RETURN_IMMEDIATELY, esta llamada devuelve inmediatamente con WBEM_S_NO_ERROR. El parámetro ppCallResult recibe un puntero a un nuevo objeto IWbemCallResult , que luego se puede sondear para obtener el resultado mediante el método GetCallStatus .

Valor devuelto

Este método devuelve un valor HRESULT que indica el estado de la llamada al método. En la lista siguiente se muestra el valor contenido en un HRESULT.

Si se produce un error, puede obtener cualquier información disponible de la función COM GetErrorInfo.

También se pueden devolver códigos de error específicos de COM si los problemas de red hacen que pierdas la conexión remota a la administración de Windows.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista
Servidor mínimo compatible Windows Server 2008
Plataforma de destino Windows
Encabezado wbemcli.h (include Wbemidl.h)
Library Wbemuuid.lib
Archivo 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

Consulte también

IWbemServices

IWbemServices::D eleteClassAsync

Recuperación de un código de error