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