Функция WPUOpenCurrentThread (ws2spi.h)

Статья
03/04/2024

Функция WPUOpenCurrentThread открывает дескриптор для текущего потока, который можно использовать с перекрывающимися функциями в многоуровневом поставщике услуг. Это предназначено для использования многоуровневыми поставщиками служб, которые хотят инициировать перекрывающиеся потоки ввода-вывода из потоков, не относящихся к приложению.

Синтаксис

int WPUOpenCurrentThread(
  [out] LPWSATHREADID lpThreadId,
  [out] LPINT         lpErrno
);

Параметры

[out] lpThreadId

Указатель на структуру WSATHREADID , которую затем можно передать в перекрывающуюся функцию.

[out] lpErrno

Указатель на код ошибки.

Возвращаемое значение

Если ошибка не возникает, WPUOpenCurrentThread возвращает ноль. В противном случае возвращается SOCKET_ERROR, и в lpErrno доступен определенный код ошибки.

Код ошибки	Значение
WSANOTINITIALISED	Перед использованием этой функции должен быть выполнен успешный вызов WSPStartup .

Функция WPUOpenCurrentThread предоставляет указатель на структуру WSATHREADID , которую затем можно передать в перекрывающуюся функцию , например LPWSPSend или LPWSPRecv. Многоуровневые поставщики служб, использующие частный поток в одном из верхних слоев, будут использовать WPUOpenCurrentThread Для передачи указателя WSATHREADID на нижний слой, который администрирует перекрывающиеся функции.

Перекрывающиеся функции, такие как LPWSPSend и LPWSPRecv , можно использовать так же, как обычный поставщик услуг.

Каждый вызов WPUOpenCurrentThread должен иметь соответствующий вызов WPUCloseThread.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	ws2spi.h

См. также раздел

WPUCloseThread

LPWSPRecv

LPWSPSend

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