Método SWbemServices.DeleteAsync

El método DeleteAsync del objeto SWbemServices elimina la clase o instancia especificada en la ruta de acceso del objeto. La llamada al método DeleteAsync se devuelve inmediatamente y los resultados y el estado se devuelven al autor de la llamada a través de eventos entregados al receptor especificado en objWbemSink. Para más información sobre cómo crear un receptor, consulte Recepción de un evento WMI. Solo puede eliminar objetos del espacio de nombres al que está conectado.

Si un proveedor dinámico proporciona la clase o instancia, a veces no es posible eliminar este objeto a menos que el proveedor admita la eliminación de clases o instancias.

Se llama al método en el modo asincrónico. Para más información, vea Llamada a un método.

Para obtener una explicación de esta sintaxis, vea Convenciones de documentación para la API de scripting.

Sintaxis

SWbemServices.DeleteAsync( _
  [ ByVal ObjWbemSink ], _
  ByVal strObjectPath, _
  [ ByVal iFlags ], _
  [ ByVal objWbemNamedValueSet ], _
  [ ByVal objWbemAsyncContext ] _
)

Parámetros

ObjWbemSink [opcional]

Receptor de objetos que recibe los resultados de la eliminación. Cree un objeto SWbemSink para recibir los objetos.

strObjectPath

Necesario. Cadena que contiene la ruta de acceso al objeto que quiere eliminar. Para más información, consulte Descripción de la ubicación de un objeto WMI.

iFlags [opcional]

Determina si se devuelven las actualizaciones de estado. Este parámetro puede aceptar los valores siguientes.

wbemFlagSendStatus (128 (0x80))

Hace que las llamadas asincrónicas envíen actualizaciones de estado al controlador de eventos OnProgress para el receptor de objetos.

wbemFlagDontSendStatus (0 (0x0))

Impide que las llamadas asincrónicas envíen actualizaciones de estado al controlador de eventos OnProgress para el receptor de objetos.

objWbemNamedValueSet [opcional]

Normalmente, esto no está definido. De lo contrario, se trata de un objeto SWbemNamedValueSet cuyos elementos representan la información de contexto que puede usar el proveedor que atiende la solicitud. Un proveedor que admita o necesite esa información debe documentar los nombres de valor reconocidos, el tipo de datos del valor, los valores permitidos y la semántica.

objWbemAsyncContext [opcional]

Objeto SWbemNamedValueSet que se devuelve al receptor del objeto para identificar el origen de la llamada asincrónica original. Use este parámetro si va a realizar varias llamadas asincrónicas mediante el mismo receptor de objetos. Para usar este parámetro, cree un objeto SWbemNamedValueSet y use el método SWbemNamedValueSet.Add para agregar un valor que identifique la llamada asincrónica que realiza. Este objeto SWbemNamedValueSet se devuelve al receptor del objeto y el origen de la llamada se puede extraer mediante el método SWbemNamedValueSet.Item. Para más información, vea Llamada a un método.

Valor devuelto

Este método no devuelve ningún valor. Si la llamada se realiza correctamente, el receptor del objeto recibe la notificación de la eliminación.

Códigos de error

Después de completar el método DeleteAsync, el objeto Err puede contener uno de los códigos de error de la lista siguiente.

wbemErrFailed - 2147749889 (0x80041001)

Error no especificado.

wbemErrInvalidParameter: 2147749896 (0x80041008)

Se ha especificado un parámetro no válido.

wbemErrOutOfMemory: 2147749894 (0x80041006)

No hay suficiente memoria para completar la operación.

wbemErrTransportFailure - 2147749909 (0x80041015)

Se ha producido un error de red que impide el funcionamiento normal.

wbemErrAccessDenied - 2147749891 (0x80041003)

El nombre de usuario y la contraseña actuales o especificados no son válidos o no están autorizados para establecer la conexión.

wbemErrNotFound: 2147749890 (0x80041002)

No se encontró el elemento solicitado.

Comentarios

Esta llamada se devuelve inmediatamente. El estado de la operación de eliminación se devuelve al autor de la llamada a través de una devolución de llamada entregada al receptor especificado en objWbemSink. Puede realizar el procesamiento final en la implementación del evento objWbemSink.OnCompleted.

Una devolución de llamada asincrónica permite a un usuario no autenticado proporcionar datos al receptor. Esto supone riesgos de seguridad para los scripts y las aplicaciones. Para eliminar los riesgos, consulte Establecimiento de la seguridad en una llamada asincrónica.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista
Servidor mínimo compatible	Windows Server 2008
Encabezado	Wbemdisp.h
Biblioteca de tipos	Wbemdisp.tlb
Archivo DLL	Wbemdisp.dll
CLSID	CLSID_SWbemServices
IID	IID_ISWbemServices

Consulte también

SWbemServices

SWbemObjectPath