WPUOpenCurrentThread-Funktion (ws2spi.h)

Die WPUOpenCurrentThread-Funktion öffnet ein Handle für den aktuellen Thread, der mit überlappenden Funktionen in einem mehrschichtigen Dienstanbieter verwendet werden kann. Dies soll von mehrstufigen Dienstanbietern verwendet werden, die überlappende E/A-Vorgänge von Nichtanwendungsthreads initiieren möchten.

Syntax

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

Parameter

[out] lpThreadId

Zeiger auf eine WSATHREADID-Struktur , die dann an eine überlappende Funktion übergeben werden kann.

[out] lpErrno

Zeiger auf den Fehlercode.

Rückgabewert

Wenn kein Fehler auftritt, gibt WPUOpenCurrentThread die Null zurück. Andernfalls wird SOCKET_ERROR zurückgegeben, und ein bestimmter Fehlercode ist in lpErrno verfügbar.

Fehlercode	Bedeutung
WSANOTINITIALISIERT	Vor der Verwendung dieser Funktion muss ein erfolgreicher WSPStartup-Aufruf erfolgen.

 

 

Hinweise

Die WPUOpenCurrentThread-Funktion stellt einen Zeiger auf eine WSATHREADID-Struktur bereit, die dann an eine überlappende Funktion wie LPWSPSend oder LPWSPRecv übergeben werden kann. Mehrschichtige Dienstanbieter, die einen privaten Thread in einer der oberen Ebenen verwenden , verwenden WPUOpenCurrentThread , um einen WSATHREADID-Zeiger an die untere Ebene zu übergeben, die überlappende Funktionen verwaltet.

Überlappende Funktionen wie LPWSPSend und LPWSPRecv können dann auf die gleiche Weise wie ein regulärer Dienstanbieter verwendet werden.

Jeder Aufruf von WPUOpenCurrentThread muss über einen entsprechenden Aufruf von WPUCloseThread verfügen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	ws2spi.h

Weitere Informationen

WPUCloseThread

LPWSPRecv

LPWSPSend