Fonction de rappel LPWSPGETQOSBYNAME (ws2spi.h)

Article
03/04/2024

La fonction WSPGetQOSByName initialise une structure QOS basée sur un modèle nommé ou récupère une énumération des noms de modèles disponibles.

Syntaxe

LPWSPGETQOSBYNAME Lpwspgetqosbyname;

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

Paramètres

[in] s

Descripteur identifiant un socket.

[in, out] lpQOSName

Spécifie le nom du modèle QOS ou fournit une mémoire tampon pour récupérer une énumération des noms de modèles disponibles.

[out] lpQOS

Pointeur vers la structure QOS à remplir.

[out] lpErrno

Pointeur vers le code d’erreur.

Valeur retournée

Si la fonction réussit, la valeur de retour est TRUE. Si la fonction échoue, la valeur de retour est FALSE et un code d’erreur spécifique est disponible dans lpErrno.

Code d'erreur	Signification
WSAENETDOWN	Le sous-système réseau a échoué.
WSAENOTSOCK	Le descripteur n’est pas un socket.
WSAENOTSOCK	L’argument lpQOS n’est pas une partie valide de l’espace d’adressage utilisateur ou la longueur de la mémoire tampon pour lpQOS est trop petite.
WSAEINVAL	Le nom de modèle QOS spécifié n’est pas valide.

Remarques

Les clients peuvent utiliser WSPGetQOSByName pour initialiser une structure QOS sur un ensemble de valeurs connues appropriées pour une classe de service ou un type de média particulier. Ces valeurs sont stockées dans un modèle référencé par un nom bien connu. Le client peut récupérer ces valeurs en définissant le membre buf du WSABUF indiqué par lpQOSName pour qu’il pointe vers une chaîne Unicode de longueur différente de zéro spécifiant un nom de modèle. Dans ce cas, l’utilisation de lpQOSName est IN uniquement et les résultats sont retournés via lpQOS.

Le client peut également utiliser LPWSPGetQOSByName pour récupérer une énumération des noms de modèles disponibles. Pour ce faire, le client peut définir le membre buf du WSABUF indiqué par lpQOSName sur une chaîne Unicode de longueur null nulle. Dans ce cas, la mémoire tampon indiquée par buf est remplacée par une séquence d’autant de chaînes de noms de modèle Unicode terminées par null que sont disponibles jusqu’au nombre d’octets disponibles dans buf , tel qu’indiqué par le membre len du WSABUF indiqué par lpQOSName. La liste des noms elle-même est terminée par une chaîne de nom Unicode de longueur nulle. Lorsque LPWSPGetQOSByName est utilisé pour récupérer des noms de modèles, le paramètre lpQOS est ignoré.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
En-tête	ws2spi.h

Voir aussi

LPWSPAccept

LPWSPConnect

LPWSPGetSockopt

Partager via