WSAGetServiceClassNameByClassIdA, fonction (winsock2.h)

Article
08/27/2023

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
WSA_INVALID_PARAMETER	Le paramètre lpServiceClassId spécifié n’est pas valide.
WSA_NOT_ENOUGH_MEMORY	La mémoire était insuffisante pour effectuer l’opération.
WSAEACCES	La routine appelante ne dispose pas de privilèges suffisants pour accéder aux informations.
WSAEFAULT	La mémoire tampon spécifiée vers laquelle pointe lpszServiceClassName est trop petite. Passez une mémoire tampon plus grande.
WSAENOBUFS	Aucun espace de mémoire tampon disponible.
WSAEOPNOTSUPP	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.
WSANO_DATA	LpServiceClassId est valide, mais aucune donnée du type demandé 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 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

Voir aussi

WSAStartup

Winsock Functions

Référence Winsock

Partager via