WPUQuerySocketHandleContext-Funktion (ws2spi.h)
Die WPUQuerySocketHandleContext-Funktion fragt den Kontextwert ab, der dem angegebenen Sockethandle zugeordnet ist.
Syntax
int WPUQuerySocketHandleContext(
[in] SOCKET s,
[out] PDWORD_PTR lpContext,
[out] LPINT lpErrno
);
Parameter
[in] s
Beschreibung, die den Socket identifiziert, dessen Kontext abgefragt werden soll.
[out] lpContext
Zeiger, der den Kontextwert empfängt.
[out] lpErrno
Zeiger auf den Fehlercode.
Rückgabewert
Wenn kein Fehler auftritt, gibt WPUQuerySocketHandleContext null zurück und speichert den aktuellen Kontextwert in lpContext. Andernfalls wird SOCKET_ERROR zurückgegeben, und ein bestimmter Fehlercode ist in lpErrno verfügbar.
| Fehlercode | Bedeutung |
|---|---|
| Der Deskriptor ist kein Socket, der von WPUCreateSocketHandle erstellt wurde. |
Hinweise
Die WPUQuerySocketHandleContext-Funktion fragt den aktuellen Kontextwert ab, der dem angegebenen Sockethandle zugeordnet ist. Dienstanbieter verwenden diese Funktion in der Regel, um einen Zeiger auf anbieterspezifische Daten abzurufen, die dem Socket zugeordnet sind. Beispielsweise kann ein Dienstanbieter den Socketkontext verwenden, um einen Zeiger auf eine Struktur zu speichern, die den Zustand des Sockets, lokale und Remotetransportadressen sowie Ereignisobjekte zum Signalisieren von Netzwerkereignissen enthält.
Nur Nicht-IFS-Anbieter verwenden diese Funktion, da IFS-Anbieter keinen Kontextwert angeben können.
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 |