Fonction WPUOpenCurrentThread (ws2spi.h)
La fonction WPUOpenCurrentThread ouvre un handle au thread actif qui peut être utilisé avec des fonctions qui se chevauchent dans un fournisseur de services en couches. Il est destiné à être utilisé par les fournisseurs de services en couches qui souhaitent lancer des E/S qui se chevauchent à partir de threads non d’application.
Syntaxe
int WPUOpenCurrentThread(
[out] LPWSATHREADID lpThreadId,
[out] LPINT lpErrno
);
Paramètres
[out] lpThreadId
Pointeur vers une structure WSATHREADID qui peut ensuite être passée à une fonction qui se chevauche.
[out] lpErrno
Pointeur vers le code d’erreur.
Valeur retournée
Si aucune erreur ne se produit, WPUOpenCurrentThread retourne le zéro. Sinon, il retourne SOCKET_ERROR, et un code d’erreur spécifique est disponible dans lpErrno.
| Code d'erreur | Signification |
|---|---|
| Un appel WSPStartup réussi doit se produire avant d’utiliser cette fonction. |
Remarques
La fonction WPUOpenCurrentThread fournit un pointeur vers une structure WSATHREADID qui peut ensuite être passée à une fonction superposée telle que LPWSPSend ou LPWSPRecv. Les fournisseurs de services en couches utilisant un thread privé dans l’une des couches supérieures utilisent WPUOpenCurrentThread pour passer un pointeur WSATHREADID à la couche inférieure qui administre les fonctions superposées.
Les fonctions qui se chevauchent, telles que LPWSPSend et LPWSPRecv , peuvent ensuite être utilisées de la même manière qu’un fournisseur de services standard.
Chaque appel à WPUOpenCurrentThread doit avoir un appel correspondant à WPUCloseThread.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | ws2spi.h |