Método ISWbemSink::Cancel
El método Cancel del objeto SWbemSink cancela todas las operaciones asincrónicas pendientes asociadas a este receptor de objetos.
Para una explicación de esta sintaxis, consulte Convenciones de documentación para la API de scripting.
Sintaxis
SWbemSink.Cancel()
Parámetros
Este método no tiene parámetros.
Valor devuelto
Este método no devuelve ningún valor.
Códigos de error
Tras la finalización del método Cancel, el objeto Err puede contener uno de los códigos de error siguientes.
-
wbemErrFailed - 2147749889 (0x80041001)
-
Error no especificado.
-
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.
Comentarios
No se puede cancelar solo una llamada asincrónica. Si hay varias llamadas asincrónicas pendientes que usan este receptor de objetos, este método las cancela todas. No afectará a las llamadas asincrónicas asociadas a otros receptores de objetos.
No se puede asignar este receptor a Nothing para cancelar una operación asincrónica. Debe llamar al método Cancel para que WMI detenga la operación y libere los recursos asociados. Esto es muy importante con las operaciones asincrónicas largas, como las consultas o las operaciones que nunca se completan, como ExecNotificationQueryAsync.
Nota
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 la comunicación semisincrónica o sincrónica. Para más información, consulte Llamada a un método.
En el ejemplo siguiente se muestra cómo cancelar una llamada asincrónica.
objwbemsink.Cancel()
set objwbemsink= Nothing
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible |
Windows Vista |
| Servidor mínimo compatible |
Windows Server 2008 |
| Encabezado |
|
| IDL |
|
| Archivo DLL |
|
| CLSID |
CLSID_SWbemSink |
| IID |
IID_ISWbemSink |