WSAInstallServiceClassW, fonction (winsock2.h)
La fonction WSAInstallServiceClass inscrit un schéma de classe de service dans un espace de noms. Ce schéma inclut le nom de classe, l’identificateur de classe et toutes les informations spécifiques à l’espace de noms qui sont communes à toutes les instances du service, telles que l’identificateur SAP ou l’identificateur d’objet.
Syntaxe
INT WSAAPI WSAInstallServiceClassW(
[in] LPWSASERVICECLASSINFOW lpServiceClassInfo
);
Paramètres
[in] lpServiceClassInfo
Informations de mappage de type spécifique de la classe de service à l’espace de noms. Plusieurs mappages peuvent être gérés en même temps.
Consultez la section Structures de données de classe de service pour obtenir une description des structures de données pertinentes.
Valeur retournée
La valeur de retour est zéro si l’opération a réussi. Sinon, la valeur SOCKET_ERROR est retournée et un numéro d’erreur spécifique peut être récupéré en appelant WSAGetLastError.
| Code d'erreur | Signification |
|---|---|
| Le fournisseur d’espaces de noms ne peut pas fournir les informations de classe demandées. | |
| La mémoire était insuffisante pour effectuer l’opération. | |
| La fonction appelante ne dispose pas des privilèges suffisants pour installer le service. | |
| Les informations de classe de service ont déjà été inscrites pour cet identificateur de classe de service. Pour modifier les informations de classe de service, commencez par utiliser WSARemoveServiceClass, puis réinstallez avec les données d’informations de classe mises à jour. | |
| Les informations de la classe de service n’étaient pas valides ou mal structurées. Cette erreur est retournée si le paramètre lpServiceClassInfo a la valeur NULL. | |
| L'opération n'est pas prise en charge. Cette erreur est retournée si le fournisseur d’espaces de noms n’implémente pas cette fonction. | |
| Le nom demandé est valide, mais aucune donnée du type requis n'a été trouvée. | |
| Le WS2_32.DLL n’a pas été initialisé. L’application doit d’abord appeler WSAStartup avant d’appeler les fonctions Windows Sockets. |
Remarques
Notes
L’en-tête winsock2.h définit WSAInstallServiceClass en tant qu’alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. La combinaison de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.
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 | winsock2.h |
| Bibliothèque | Ws2_32.lib |
| DLL | Ws2_32.dll |