WSAGetServiceClassNameByClassIdA, fonction (winsock2.h)

  • Article

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