Función CancelSynchronousIo
Marca las operaciones de E/S sincrónicas pendientes emitidas por el subproceso especificado como canceladas.
Sintaxis
BOOL WINAPI CancelSynchronousIo(
_In_ HANDLE hThread
);
Parámetros
hThread[in]
Identificador del subproceso.
Valor devuelto
Si la función se realiza correctamente, el valor devuelto es distinto de cero.
Si se produce un error en la función, el valor devuelto es 0 (cero). Para obtener información de error extendida, llame a la función GetLastError .
Si esta función no encuentra una solicitud para cancelar, el valor devuelto es 0 (cero) y GetLastError devuelve ERROR_NOT_FOUND.
Notas
El autor de la llamada debe tener el derecho de acceso THREAD_TERMINATE .
Si hay operaciones de E/S pendientes en curso para el subproceso especificado, la función CancelSynchronousIo las marca para la cancelación. La mayoría de los tipos de operaciones se pueden cancelar inmediatamente; otras operaciones pueden continuar hasta su finalización antes de que se cancelen realmente y se notifique al autor de la llamada. La función CancelSynchronousIo no espera a que se completen todas las operaciones canceladas. Para obtener más información, consulte Instrucciones de finalización o cancelación de E/S.
La operación que se cancela se completa con uno de los tres estados; Debe comprobar el estado de finalización para determinar el estado de finalización. Los tres estados son:
- La operación se completó normalmente. Esto puede ocurrir incluso si se canceló la operación, ya que es posible que la solicitud de cancelación no se haya enviado a tiempo para cancelar la operación.
- Operación cancelada. La función GetLastError devuelve ERROR_OPERATION_ABORTED.
- Error en la operación con otro error. La función GetLastError devuelve el código de error correspondiente.
En Windows 8 y Windows Server 2012, esta función es compatible con las siguientes tecnologías.
| Technology | Compatible |
|---|---|
| Protocolo bloque de mensajes del servidor (SMB) 3.0 | Sí |
| Conmutación por error transparente (TFO) de SMB 3.0 | Sí |
| SMB 3.0 con recursos compartidos de archivos de escalabilidad horizontal (SO) | Sí |
| Sistema de archivos de volumen compartido de clúster (CsvFS) | Sí |
| Sistema de archivos resistente a errores (ReFS) | Sí |
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2008 [solo aplicaciones de escritorio] |
| Encabezado | IoAPI.h (incluye Windows.h); WinBase.h en Windows Server 2008 R2, Windows 7, Windows Server 2008 y Windows Vista (incluye Windows.h) |
| Biblioteca | Kernel32.lib |
| Archivo DLL | Kernel32.dll |