Функция CancelThreadpoolIo (threadpoolapiset.h)
Отменяет уведомление от функции StartThreadpoolIo .
Синтаксис
void CancelThreadpoolIo(
[in, out] PTP_IO pio
);
Параметры
[in, out] pio
Указатель на структуру TP_IO , которая определяет объект завершения ввода-вывода. Функция CreateThreadpoolIo возвращает этот указатель.
Возвращаемое значение
None
Remarks
Чтобы предотвратить утечку памяти, необходимо вызвать функцию CancelThreadpoolIo в любом из следующих сценариев:
- Перекрывающаяся (асинхронная) операция ввода-вывода завершается сбоем (т. е. вызов асинхронной функции ввода-вывода возвращает ошибку с кодом ошибки, отличной от ERROR_IO_PENDING).
- Асинхронная операция ввода-вывода возвращается немедленно с успехом, а дескриптор файла, связанный с объектом завершения ввода-вывода, имеет режим уведомлений FILE_SKIP_COMPLETION_PORT_ON_SUCCESS. Дескриптор файла не уведомляет порт завершения ввода-вывода, и связанная функция обратного вызова ввода-вывода не будет вызвана.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows Vista [классические приложения | Приложения UWP] |
| Минимальная версия сервера | Windows Server 2008 [классические приложения | Приложения UWP] |
| Целевая платформа | Windows |
| Header | threadpoolapiset.h (включая Windows.h в Windows 7, Windows Server 2008 Windows Server 2008 R2) |
| Библиотека | Kernel32.lib |
| DLL | Kernel32.dll |