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

El método IWbemServices::D eleteClassAsync elimina la clase especificada del espacio de nombres actual. Este método es idéntico a IWbemServices::D eleteClass , salvo que la llamada devuelve inmediatamente. La confirmación o el error se notifican de forma asincrónica al receptor de objetos especificado mediante el método IWbemObjectSink::SetStatus una vez completada la operación.

Sintaxis

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

Parámetros

[in] strClass

Nombre de la clase destinada a su eliminación.

[in] lFlags

Uno o varios de los valores siguientes son válidos.

WBEM_FLAG_SEND_STATUS

Esta marca registra con Administración de Windows una solicitud para recibir informes de estado intermedios a través de la implementación del cliente de IWbemObjectSink::SetStatus. La implementación del proveedor debe admitir informes de estado intermedios, para que esta marca cambie el comportamiento.

WBEM_FLAG_OWNER_UPDATE

Los proveedores de inserción deben especificar esta marca al llamar a DeleteClassAsync para indicar que esta clase ha cambiado.

[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.

[in] pResponseHandler

Puntero a una implementación de IWbemObjectSink implementada por el autor de la llamada. Este controlador recibe el estado de la solicitud de eliminación cuando está disponible a través del método IWbemObjectSink::SetStatus . Si se devuelve algún código de error, no se usa el puntero IWbemObjectSink proporcionado. Si se devuelve WBEM_S_NO_ERROR , se llama a la implementación IWbemObjectSink del usuario para indicar el resultado de la operación. Administración de Windows solo llama a AddRef en el puntero en los casos en los que WBEM_S_NO_ERROR devuelve. En los casos en los que se devuelve un código de error, el recuento de referencias es el mismo que en la entrada. Para obtener una explicación detallada de este parámetro, vea Llamar a un método.

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.

Todos los demás códigos de retorno se proporcionan al receptor de objetos especificado por el parámetro pReponseHandler a través del método SetStatus . Las condiciones de error, como cuando la clase no existe o el usuario no tiene permiso para eliminar clases, se notifican al controlador. No se notifican en el código de retorno de este método.

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

Comentarios

Si un proveedor de instancias dinámicas está asociado a la clase , el proveedor no se registra y ya no se llama a para esa clase. Las clases que derivan de la clase eliminada también se eliminan y sus proveedores asociados se anulan el registro. 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ámico proporciona la clase , el éxito de la eliminación depende de si ese proveedor admite la eliminación de clases.

Nota No se pueden eliminar las clases del sistema estándar.
 
Dado que es posible que la devolución de llamada no se devuelva en el mismo nivel de autenticación que requiere el cliente, se recomienda usar la semisynchronous en lugar de la comunicación asincrónica. Si necesita comunicación asincrónica, consulte Llamar a un método.

Para obtener más información sobre el uso de métodos de forma semiincrónica, vea IWbemServices::D eleteClass y Llamar a un método.

Requisitos

   
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 eleteClass

Recuperación de un código de error