Método SWbemObject.DeleteAsync_

El método DeleteAsync_ de SWbemObject elimina asincrónicamente la clase actual o la instancia actual. 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.

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

Sintaxis

SWbemObject.DeleteAsync_( _
  ByVal objWbemSink, _
  [ ByVal iFlags ], _
  [ ByVal objwbemNamedValueSet ], _
  [ ByVal objWbemAsyncContext ] _
)

Parámetros

objWbemSink [en]

Receptor de objetos que devuelve el resultado de la operación de eliminación.

iFlags [entrada, opcional]

Entero que determina el comportamiento de la llamada. 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 SWbemSink.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 [entrada, opcional]

Este parámetro normalmente 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 [entrada, opcional]

Se trata de un objeto SWbemNamedValueSet que se devuelve al receptor del objeto para identificar el origen de la llamada asincrónica original. Use este parámetro si realiza 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 esta llamada se realiza correctamente, el resultado de la operación de eliminación se proporciona a través del receptor de objetos proporcionado.

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.

wbemErrAccessDenied - 2147749891 (0x80041003)

El contexto actual no tiene derechos de seguridad adecuados para eliminar el objeto.

wbemErrFailed - 2147749890 (0x80041002)

Error no especificado.

wbemErrInvalidClass: 2147749904 (0x80041010)

La clase especificada no existe.

wbemErrInvalidOperation - 2147749910 (0x80041016)

No se puede eliminar el objeto.

wbemErrNotFound: 2147749890 (0x80041002)

El objeto no existía.

wbemErrOutOfMemory - 2147749894 (0x80041006)

No hay suficiente memoria para completar la operación.

Comentarios

Esta llamada se devuelve inmediatamente. El estado se devuelve al autor de la llamada a través de una devolución de llamada entregada al receptor especificado en objWbemSink.

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, use comunicación semisincrónica o sincrónica. Para más información, consulte Llamada a un método.

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_SWbemObject
IID	IID_ISWbemObject