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

  • Artículo

El método IWbemServices::D eleteInstanceAsync elimina asincrónicamente una instancia de una clase existente en el espacio de nombres actual. La confirmación o el error de la operación se notifica a través de la interfaz IWbemObjectSink implementada por el autor de la llamada.

Sintaxis

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

Parámetros

[in] strObjectPath

BSTR válido que contiene la ruta de acceso del objeto que se va a eliminar.

[in] lFlags

WBEM_FLAG_SEND_STATUS 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. Tenga en cuenta que la marca WBEM_FLAG_USE_AMENDED_QUALIFIERS no se puede usar aquí.

[in] pCtx

Normalmente , NULL. De lo contrario, se trata de un puntero a un objeto IWbemContext que puede usar el proveedor que está eliminando la instancia. Los valores del objeto de contexto deben especificarse en la documentación del proveedor en cuestión.

[in] pResponseHandler

Puntero a la implementación del autor de la llamada de IWbemObjectSink. Este controlador recibe el estado de la operación de eliminación a medida que está disponible a través del método 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 más información, vea Llamada 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.

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

Si DeleteInstanceAsync devuelve WBEM_S_NO_ERROR, WMI espera un resultado del método SetStatus del controlador de respuesta. WMI espera indefinidamente en una conexión local o hasta que se produzca un tiempo de espera de conexión remota.

Otras condiciones de error se notifican de forma asincrónica al receptor de objetos proporcionado por el parámetro pResponseHandler .

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 administración de Windows.

Nota Los clientes que llaman a DeleteInstanceAsync siempre deben esperar que los resultados de la llamada se notifiquen mediante su método IWbemObjectSink::Indicate .
 
Nota Cuando la instancia a la que apunta strObjectPath pertenece a una clase que es miembro de una jerarquía de clases, el éxito de DeleteInstanceAsync depende del proveedor no abstracto superior. Para obtener una explicación detallada de las dependencias implicadas que determinan el éxito de esta operación, vea Comentarios en IWbemServices::D eleteInstance.
 

Comentarios

Un proveedor de instancias puede notificar el éxito o el error con el código devuelto de DeleteInstanceAsync o mediante una llamada a SetStatus realizada a través de pResponseHandler. Si se envía a SetStatus, el código de retorno enviado al receptor a través de pResponseHandler tiene prioridad. 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 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 eleteInstance y Llamada 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

Llamada a un método

Descripción de una ruta de acceso de objeto de instancia

IWbemServices

IWbemServices::DeleteInstance