Share via

WPUQuerySocketHandleContext-Funktion (ws2spi.h)

  • Artikel

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

Weitere Informationen

WPUCreateSocketHandle