WSAInstallServiceClassA, 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 WSAInstallServiceClassA(
  [in] LPWSASERVICECLASSINFOA lpServiceClassInfo
);

Paramètres

[in] lpServiceClassInfo

Informations de mappage spécifiques 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
WSA_INVALID_PARAMETER
Le fournisseur d’espaces de noms ne peut pas fournir les informations de classe demandées.
WSA_NOT_ENOUGH_MEMORY
La mémoire était insuffisante pour effectuer l’opération.
WSAEACCES
La fonction appelante ne dispose pas des privilèges suffisants pour installer le service.
WSAEALREADY
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.
WSAEINVAL
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.
WSAEOPNOTSUPP
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.
WSANO_DATA
Le nom demandé est valide, mais aucune donnée du type requis n'a été trouvée.
WSANOTINITIALISED
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 comme un 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.

Configuration requise

   
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

Voir aussi

WSAGetLastError

WSAGetServiceClassInfo

WSASERVICECLASSINFO

Fonctions Winsock

Informations de référence sur Winsock