Поделиться через


Функция 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. Дескриптор файла не уведомляет порт завершения ввода-вывода, и связанная функция обратного вызова ввода-вывода не будет вызвана.
Чтобы скомпилировать приложение, использующее эту функцию, определите _WIN32_WINNT как 0x0600 или выше.

Требования

Требование Значение
Минимальная версия клиента 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

См. также

CloseThreadpoolIo

CreateThreadpoolIo

StartThreadpoolIo

Пулы потоков

WaitForThreadpoolIoCallbacks