WSAGetServiceClassNameByClassIdA, fonction (winsock2.h)

Article
11/20/2024

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, tel que 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, la longueur de la mémoire tampon retournée par lpszServiceClassName, en caractères. En sortie, la longueur du nom du service copié dans lpszServiceClassName, en caractères.

Valeur de retour

La fonction WSAGetServiceClassNameByClassId retourne la valeur zéro si elle réussit. 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 d’appel n’a pas suffisamment de privilèges pour accéder aux informations.
WSAEFAULT	La mémoire tampon spécifiée pointée par lpszServiceClassName est trop petite. Passez une mémoire tampon plus grande.
WSAENOBUFS	Aucun espace tampon n’est 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 sur la classe de service.
WSANO_DATA	L'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 des fonctions Windows Sockets.

Remarques

Note

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. 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 \| Applications UWP]
serveur minimum pris en charge	Windows 2000 Server [applications de bureau \| Applications UWP]
plateforme cible	Windows
d’en-tête	winsock2.h
bibliothèque	Ws2_32.lib
DLL	Ws2_32.dll

Voir aussi

WSAStartup

fonctions Winsock

de référence Winsock

Partager via