Función CancelSynchronousIo (ioapiset.h)

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.

Requisitos

Vea también

CancelIo

CancelIoEx

Funciones de administración de archivos

E/S sincrónica y asincrónica