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.

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

Weitere Informationen

WPUCreateSocketHandle