WSAGetServiceClassNameByClassIdA, fonction (winsock2.h)
La fonction WSAGetServiceClassNameByClassId récupère le nom du service associé au type spécifié. Ce nom est le nom de service générique, comme FTP ou SNA, et non le nom d’une instance spécifique de ce service.
Syntaxe
INT WSAAPI WSAGetServiceClassNameByClassIdA(
[in] LPGUID lpServiceClassId,
[out] LPSTR lpszServiceClassName,
[in, out] LPDWORD lpdwBufferLength
);
Paramètres
[in] lpServiceClassId
Pointeur vers le GUID de la classe de service.
[out] lpszServiceClassName
Pointeur vers le nom du service.
[in, out] lpdwBufferLength
Lors de l’entrée, longueur de la mémoire tampon retournée par lpszServiceClassName, en caractères. Lors de la sortie, longueur du nom du service copiée dans lpszServiceClassName, en caractères.
Valeur retournée
La fonction WSAGetServiceClassNameByClassId retourne une valeur de zéro en cas de réussite. 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 paramètre lpServiceClassId spécifié n’est pas valide. | |
| La mémoire était insuffisante pour effectuer l’opération. | |
| La routine appelante ne dispose pas de privilèges suffisants pour accéder aux informations. | |
| La mémoire tampon spécifiée vers laquelle pointe lpszServiceClassName est trop petite. Passez une mémoire tampon plus grande. | |
| Aucun espace de mémoire tampon disponible. | |
| L’opération n’est pas prise en charge pour le type d’objet référencé. Cette erreur est retournée par certains fournisseurs d’espaces de noms qui ne prennent pas en charge l’obtention d’informations de classe de service. | |
| LpServiceClassId 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 les fonctions Windows Sockets. |
Remarques
Notes
L’en-tête winsock2.h définit WSAGetServiceClassNameByClassId 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. 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 | Applications UWP] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau | Applications UWP] |
| Plateforme cible | Windows |
| En-tête | winsock2.h |
| Bibliothèque | Ws2_32.lib |
| DLL | Ws2_32.dll |