Share via

Función CancelSynchronousIo

  • Artículo

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

Vea también

CancelIo

CancelIoEx

Funciones de administración de archivos

E/S sincrónica y asincrónica