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