Funzione WPUQuerySocketHandleContext (ws2spi.h)

Articolo
03/04/2024

La funzione WPUQuerySocketHandleContext esegue una query sul valore di contesto associato all'handle socket specificato.

Sintassi

int WPUQuerySocketHandleContext(
  [in]  SOCKET     s,
  [out] PDWORD_PTR lpContext,
  [out] LPINT      lpErrno
);

Parametri

[in] s

Descrizione che identifica il socket il cui contesto deve essere sottoposto a query.

[out] lpContext

Puntatore che riceverà il valore di contesto.

[out] lpErrno

Puntatore al codice di errore.

Valore restituito

Se non si verifica alcun errore, WPUQuerySocketHandleContext restituisce zero e archivia il valore di contesto corrente in lpContext. In caso contrario, restituisce SOCKET_ERROR e un codice di errore specifico è disponibile in lpErrno.

Codice di errore	Significato
WSAENOTSOCK	Il descrittore non è un socket creato da WPUCreateSocketHandle.

Commenti

La funzione WPUQuerySocketHandleContext esegue una query sul valore di contesto corrente associato all'handle socket specificato. I provider di servizi usano in genere questa funzione per recuperare un puntatore ai dati specifici del provider associati al socket. Ad esempio, un provider di servizi può usare il contesto del socket per archiviare un puntatore a una struttura contenente lo stato del socket, gli indirizzi di trasporto locali e remoti e gli oggetti evento per segnalare gli eventi di rete.

Solo i provider non IFS usano questa funzione, perché i provider IFS non sono in grado di fornire un valore di contesto.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	ws2spi.h

Vedi anche

WPUCreateSocketHandle

Condividi tramite