Função CancelSynchronousIo

Marca as operações de E/S síncronas pendentes emitidas pelo thread especificado como canceladas.

Sintaxe

BOOL WINAPI CancelSynchronousIo(
  _In_ HANDLE hThread
);

parâmetros

Hthread[in]

Um identificador para o thread.

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero.

Se a função falhar, o valor retornado será 0 (zero). Para obter informações de erro estendidas, chame a função GetLastError .

Se essa função não conseguir encontrar uma solicitação para cancelar, o valor retornado será 0 (zero) e GetLastError retornará ERROR_NOT_FOUND.

Comentários

O chamador deve ter o acesso de THREAD_TERMINATE correto.

Se houver operações de E/S pendentes em andamento para o thread especificado, a função CancelSynchronousIo as marcará para cancelamento. A maioria dos tipos de operações pode ser cancelada imediatamente; outras operações podem continuar até a conclusão antes de serem realmente canceladas e o chamador for notificado. A função CancelSynchronousIo não aguarda a conclusão de todas as operações canceladas. Para obter mais informações, consulte Diretrizes de conclusão/cancelamento de E/S.

A operação que está sendo cancelada é concluída com um dos três status; você deve marcar a status de conclusão para determinar o estado de conclusão. Os três status são:

• A operação foi concluída normalmente. Isso pode ocorrer mesmo se a operação tiver sido cancelada, pois a solicitação de cancelamento pode não ter sido enviada a tempo de cancelar a operação.
• A operação foi cancelada. A função GetLastError retorna ERROR_OPERATION_ABORTED.
• A operação falhou com outro erro. A função GetLastError retorna o código de erro relevante.

Em Windows 8 e Windows Server 2012, essa função é compatível com as tecnologias a seguir.

Requisitos

Confira também

CancelIo

CancelIoEx

Funções de gerenciamento de arquivos

E/S síncrona e assíncrona