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