Função CancelSynchronousIo

  • Artigo

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.

Tecnologia Com suporte
Protocolo SMB (Bloco de Mensagens do Servidor) 3.0 Sim
TFO (Failover Transparente) do SMB 3.0 Sim
SMB 3.0 com compartilhamentos de arquivos de expansão (SO) Sim
Sistema de arquivos de volume compartilhado de cluster (CsvFS) Sim
ReFS (Sistema de Arquivos Resiliente) Sim

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Cabeçalho IoAPI.h (inclua Windows.h);
WinBase.h no Windows Server 2008 R2, Windows 7, Windows Server 2008 e Windows Vista (inclua Windows.h)
Biblioteca Kernel32.lib
DLL Kernel32.dll

Confira também

CancelIo

CancelIoEx

Funções de gerenciamento de arquivos

E/S síncrona e assíncrona