Función CancelIo
Cancela todas las operaciones de entrada y salida pendientes (E/S) emitidas por el subproceso que realiza la llamada para el archivo especificado. La función no cancela las operaciones de E/S que otros subprocesos emiten para un identificador de archivo.
Para cancelar las operaciones de E/S desde otro subproceso, use la función CancelIoEx .
Sintaxis
BOOL WINAPI CancelIo(
_In_ HANDLE hFile
);
Parámetros
-
hFile [in]
-
Identificador del archivo.
La función cancela todas las operaciones de E/S pendientes para este identificador de archivo.
Valor devuelto
Si la función se realiza correctamente, el valor devuelto es distinto de cero. La operación de cancelación de todas las operaciones de E/S pendientes emitidas por el subproceso de llamada para el identificador de archivo especificado se solicitó correctamente. El subproceso puede usar la función GetOverlappedResult para determinar cuándo se han completado las propias operaciones de E/S.
Si se produce un error en la función, el valor devuelto es cero (0). Para obtener información de error extendida, llame a la función GetLastError .
Comentarios
Si hay alguna operación de E/S pendiente en curso para el identificador de archivo especificado y la emite el subproceso que realiza la llamada, la función CancelIo las cancela. CancelIo cancela solo la E/S pendiente en el identificador, no cambia el estado del identificador; esto significa que no puede confiar en el estado del identificador porque no puede saber si la operación se completó correctamente o se canceló.
Las operaciones de E/S deben emitirse como E/S superpuestas. Si no lo son, las operaciones de E/S no vuelven para permitir que el subproceso llame a la función CancelIo . Llamar a la función CancelIo con un identificador de archivo que no se abre con FILE_FLAG_OVERLAPPED no hace nada.
Todas las operaciones de E/S canceladas se completan con el error ERROR_OPERATION_ABORTED y todas las notificaciones de finalización de las operaciones de E/S se producen normalmente.
En Windows 8 y Windows Server 2012, esta función es compatible con las siguientes tecnologías.
| Tecnología | 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 XP [aplicaciones de escritorio | Aplicaciones para UWP] |
| Servidor mínimo compatible |
Windows Server 2003 [aplicaciones de escritorio | Aplicaciones para UWP] |
| Encabezado |
|
| Biblioteca |
|
| Archivo DLL |
|