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