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 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
Classe de service vers des informations de mappage de type spécifique à l’espace de noms. Plusieurs mappages peuvent être gérés à la fois.
Consultez la section Structures de données de classe de service pour obtenir une description des structures de données pertinentes.
Valeur de retour
La valeur de retour est égale à 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 n’a pas suffisamment de privilèges 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, utilisez d’abord WSARemoveServiceClass, puis réinstallez-les avec des données d’informations de classe mises à jour. | |
| Les informations de classe de service n’étaient pas valides ou incorrectement structurées. Cette erreur est retournée si le paramètre lpServiceClassInfo est 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 demandé n’a été trouvée. | |
| Le WS2_32.DLL n’a pas été initialisé. L’application doit d’abord appeler WSAStartup avant d’appeler des fonctions Windows Sockets. |
Remarques
Note
L’en-tête winsock2.h définit WSAInstallServiceClass comme 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. Le mélange 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.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
| serveur minimum pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| plateforme cible | Windows |
| d’en-tête | winsock2.h |
| bibliothèque | Ws2_32.lib |
| DLL | Ws2_32.dll |