WSCInstallQOSTemplate, fonction (ws2spi.h)
[ Cette fonction n’est pas prise en charge dans Windows Vista et les versions ultérieures du système d’exploitation.]
La fonction WSCInstallQOSTemplate installe le modèle QoS spécifié dans la base de données de configuration système.
Syntaxe
int WSCInstallQOSTemplate(
[in] const LPGUID Guid,
[in] LPWSABUF QosName,
[in] LPQOS Qos
);
Paramètres
[in] Guid
Identificateur global unique (GUID) pour le fournisseur de qualité de service (QoS).
[in] QosName
Pointeur vers une structure WSABUF qui contient le nom QoS du modèle à installer.
[in] Qos
Pointeur vers une structure QOS qui spécifie la qualité des spécifications de flux de service et toutes les informations spécifiques au fournisseur pour le modèle QoS.
Valeur retournée
Si la fonction WSCInstallQOSTemplate réussit, la valeur de retour est zéro. Sinon, elle retourne l’un des codes d’erreur suivants.
| Code d'erreur | Signification |
|---|---|
| Un ou plusieurs arguments ne se trouve pas dans une partie valide de l’espace d’adressage utilisateur. | |
| Un ou plusieurs arguments ne sont pas valides. Cette erreur est retournée si le fournisseur QoS spécifié dans le paramètre GUID n’est pas valide ou si le nom du modèle QoS spécifié dans le paramètre QosName n’est pas valide. Cette erreur est également retournée si le contenu de la structure de modèle spécifiée dans le paramètre Qos n’est pas valide ou incomplet. | |
| La mémoire ne peut pas être allouée pour les mémoires tampons. | |
| Une erreur non récupérable s’est produite. Cette erreur est retournée dans plusieurs conditions, notamment : le fournisseur est déjà installé, l’utilisateur n’a pas les privilèges d’administration nécessaires pour écrire dans le registre Winsock ou un échec s’est produit lors de la création ou de l’installation d’une entrée de catalogue. | |
| Un appel système qui ne devrait jamais échouer a échoué. | |
| La mémoire disponible était insuffisante. Cette erreur est retournée lorsque la mémoire est insuffisante pour allouer une nouvelle entrée de catalogue. |
Remarques
La fonction WSCInstallQOSTemplate n’est pas prise en charge sur Windows Vista et versions ultérieures. Si cette fonction est appelée sur Windows Vista et que l’erreur est retournée.
La fonction WSCInstallQOSTemplate installe un modèle QoS, basé sur un nom QoS. L’appelant de la fonction WSCInstallQOSTemplate doit disposer des droits d’administration appropriés pour que l’appel réussisse.
La structure QOS qui contient les paramètres QoS peut être récupérée ultérieurement en appelant la fonction WSPGetQOSByName et en transmettant le nom QoS associé.
La fonction WSCInstallQOSTemplate installe un modèle qoS nommé qui contient le
Structure QOS spécifiée dans le paramètre Qos . S’il existe déjà un modèle QoS avec le nom QoS spécifié dans le paramètre Qosname , les paramètres spécifiés dans le paramètre Qos remplacent les paramètres du modèle existant.
Si le paramètre Guid est défini sur NULL, le modèle QOS installé s’applique à tous les fournisseurs de services. Si le paramètre GUID n’est pas NULL, le modèle QoS installé s’applique uniquement au fournisseur indiqué par le paramètre GUID .
Les paramètres de modèle QoS étant stockés dans un stockage non volatile, les appels suivants à la fonction WSAGetQOSByName avec le même nom QoS spécifié dans le paramètre lpQOSName , retournent la même structure QOS passée à la fonction WSCInstallQOSTemplate .
Windows Sockets 2 inclut un ensemble de modèles QoS de base. Vous pouvez remplacer et remplacer l’un de ces modèles QoS ou modifier un modèle QoS existant en installant simplement un nouveau modèle avec le nom existant. Vous n’avez pas besoin de supprimer un modèle existant avant de le remplacer ou de le modifier. Vous ne pouvez pas supprimer l’ensemble de base de modèles nommés QoS inclus dans Windows Sockets 2. Toutefois, vous pouvez supprimer des modèles ajoutés par la suite, peut-être par d’autres fournisseurs de services.
Le paramètre Qos pointe vers une structure QOS qui peut inclure une mémoire tampon qui contient des paramètres spécifiques au fournisseur dans le membre ProviderSpecific de la structure QOS . Tous les paramètres spécifiques au fournisseur sont stockés avec la structure QOS de base et sont retournés dans les appels suivants à la fonction WSAGetQOSByName .
Le membre ProviderSpecific de la structure QOS peut être défini même si le paramètre GUID a la valeur NULL pour installer un modèle QoS global pour tous les fournisseurs de services. Notez que cette pratique peut amener un fournisseur de services à ignorer le membre ProviderSpecific de la structure QOS si le fournisseur de services ne reconnaît pas son contenu. L’utilisation recommandée de la fonction WSCInstallQOSTemplate consiste à inclure des paramètres spécifiques au fournisseur dans le membre ProviderSpecific de la structure QOS uniquement si le modèle nommé est installé sur un fournisseur de services particulier (le paramètre GUID n’est pas NULL).
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] |
| Plateforme cible | Windows |
| En-tête | ws2spi.h |