Função CancelThreadpoolIo (threadpoolapiset.h)

Cancela a notificação da função StartThreadpoolIo .

Sintaxe

void CancelThreadpoolIo(
  [in, out] PTP_IO pio
);

Parâmetros

[in, out] pio

Um ponteiro para uma estrutura TP_IO que define o objeto de conclusão de E/S. A função CreateThreadpoolIo retorna esse ponteiro.

Retornar valor

Nenhum

Comentários

Para evitar vazamentos de memória, você deve chamar a função CancelThreadpoolIo para qualquer um dos seguintes cenários:

  • Uma operação de E/S sobreposta (assíncrona) falha (ou seja, a chamada de função de E/S assíncrona retorna falha com um código de erro diferente de ERROR_IO_PENDING).
  • Uma operação de E/S assíncrona retorna imediatamente com êxito e o identificador de arquivo associado ao objeto de conclusão de E/S tem o modo de notificação FILE_SKIP_COMPLETION_PORT_ON_SUCCESS. O identificador de arquivo não notificará a porta de conclusão de E/S e a função de retorno de chamada de E/S associada não será chamada.
Para compilar um aplicativo que usa essa função, defina _WIN32_WINNT como 0x0600 ou superior.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho threadpoolapiset.h (inclua Windows.h no Windows 7, Windows Server 2008 Windows Server 2008 R2)
Biblioteca Kernel32.lib
DLL Kernel32.dll

Confira também

CloseThreadpoolIo

CreateThreadpoolIo

StartThreadpoolIo

Pools de threads

WaitForThreadpoolIoCallbacks