Funzione WSAGetQOSByName (winsock2.h)

Articolo
03/13/2024

La funzione WSAGetQOSByName inizializza una struttura QOS basata su un modello denominato oppure fornisce un buffer per recuperare un'enumerazione dei nomi dei modelli disponibili.

Sintassi

BOOL WSAAPI WSAGetQOSByName(
  [in]      SOCKET   s,
  [in, out] LPWSABUF lpQOSName,
  [out]     LPQOS    lpQOS
);

Parametri

[in] s

Descrittore che identifica un socket.

[in, out] lpQOSName

Puntatore a una qualità specifica del modello di servizio.

[out] lpQOS

Puntatore alla struttura QOS da riempire.

Valore restituito

Se WSAGetQOSByName ha esito positivo, il valore restituito è TRUE. Se la funzione ha esito negativo, il valore restituito è FALSE. Per ottenere informazioni sull'errore estese, chiamare WSAGetLastError.

Codice di errore	Significato
WSANOTINITIALISED	Prima di usare questa funzione, è necessario eseguire una chiamata WSAStartup riuscita.
WSAENETDOWN	Il sottosistema di rete non è riuscito.
WSAENOTSOCK	Il descrittore non è un socket.
WSAEFAULT	Il parametro lpQOSName o lpQOS non è una parte valida dello spazio degli indirizzi utente o la lunghezza del buffer per lpQOS è troppo piccola.

Commenti

La funzione WSAGetQOSByName viene usata dalle applicazioni 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 parametro buf della struttura WSABUF indicato da lpQOSName, che punta a una stringa 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 questa funzione per recuperare un'enumerazione dei nomi dei modelli disponibili. Il client può eseguire questa operazione impostando il parametro buf dell'oggetto WSABUF indicato da lpQOSName su una stringa con terminazione null a lunghezza zero. In questo caso il buffer indicato da buf viene sovrascritto con una sequenza di nomi di modelli con terminazione null fino al numero di byte disponibili in buf , come indicato dal parametro len di WSABUF indicato da lpQOSName. L'elenco dei nomi stesso viene terminato da un nome di lunghezza zero. Quando viene usata la funzione WSAGetQOSByName 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]
Piattaforma di destinazione	Windows
Intestazione	winsock2.h
Libreria	Ws2_32.lib
DLL	Ws2_32.dll