Funzione di callback LPWSPGETQOSBYNAME (ws2spi.h)

Articolo
08/28/2023

La funzione WSPGetQOSByName inizializza una struttura QOS basata su un modello denominato oppure recupera un'enumerazione dei nomi dei modelli disponibili.

Sintassi

LPWSPGETQOSBYNAME Lpwspgetqosbyname;

BOOL Lpwspgetqosbyname(
  [in]      SOCKET s,
  [in, out] LPWSABUF lpQOSName,
  [out]     LPQOS lpQOS,
  [out]     LPINT lpErrno
)
{...}

Parametri

[in] s

Descrittore che identifica un socket.

[in, out] lpQOSName

Specifica il nome del modello QOS o fornisce un buffer per recuperare un'enumerazione dei nomi dei modelli disponibili.

[out] lpQOS

Puntatore alla struttura QOS da riempire.

[out] lpErrno

Puntatore al codice di errore.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è TRUE. Se la funzione ha esito negativo, il valore restituito è FALSE e un codice di errore specifico è disponibile in lpErrno.

Codice di errore	Significato
WSAENETDOWN	Il sottosistema di rete non è riuscito.
WSAENOTSOCK	Il descrittore non è un socket.
WSAENOTSOCK	L'argomento lpQOS non è una parte valida dello spazio degli indirizzi utente o la lunghezza del buffer per lpQOS è troppo piccola.
WSAEINVAL	Il nome del modello QOS specificato non è valido.

Commenti

I client possono usare WSPGetQOSByName per inizializzare una struttura QOS in un set di valori noti appropriati per una determinata classe di servizio o un tipo di supporto specifico. Questi valori vengono archiviati in un modello a cui fa riferimento un nome noto. Il client può recuperare questi valori impostando il membro buf del WSABUF indicato da lpQOSName per puntare a una stringa Unicode di lunghezza non zero che specifica un nome modello. In questo caso l'utilizzo di lpQOSName è IN solo e i risultati vengono restituiti tramite lpQOS.

In alternativa, il client può usare LPWSPGetQOSByName per recuperare un'enumerazione dei nomi dei modelli disponibili. Il client può eseguire questa operazione impostando il membro buf dell'oggetto WSABUF indicato da lpQOSName su una stringa Unicode con terminazione null a lunghezza zero. In questo caso, il buffer indicato da buf viene sovrascritto con una sequenza di stringhe di nome modello Unicode con terminazione null, come sono disponibili fino al numero di byte disponibili in buf , come indicato dal membro len del WSABUF indicato da lpQOSName. L'elenco dei nomi stesso viene terminato da una stringa di nome Unicode a lunghezza zero. Quando viene usato LPWSPGetQOSByName per recuperare i nomi dei modelli, il parametro lpQOS viene ignorato.

Requisiti

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

Vedi anche

LPWSPAccept

LPWSPConnect

LPWSPGetSockopt

Condividi tramite