Función CancelSynchronousIo (ioapiset.h)

  • Artículo

Marca las operaciones de E/S sincrónicas pendientes emitidas por el subproceso especificado como canceladas.

Sintaxis

BOOL CancelSynchronousIo(
  [in] HANDLE hThread
);

Parámetros

[in] hThread

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.

Observaciones

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, vea Cancelar operaciones de E/S pendientes.

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 pertinente.
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

   
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado ioapiset.h (incluye Windows.h)
Library Kernel32.lib
Archivo DLL Kernel32.dll

Vea también

CancelIo

CancelIoEx

Funciones de administración de archivos

E/S sincrónica y asincrónica