getservbyname, fonction (winsock.h)

  • Article

La fonction getservbyname récupère les informations de service correspondant à un nom de service et à un protocole.

Syntaxe

servent * getservbyname(
  [in] const char *name,
  [in] const char *proto
);

Paramètres

[in] name

Pointeur vers un nom de service terminé par null.

[in] proto

Pointeur vers un nom de protocole terminé par null. Si ce pointeur a la valeur NULL, la fonction getservbyname retourne la première entrée de service où name correspond au membre s_name de la structure des services ou au membre s_aliases de la structure de service . Sinon, getservbyname correspond au nom et au proto.

Valeur retournée

Si aucune erreur ne se produit, getservbyname retourne un pointeur vers la structure de service . Sinon, elle retourne un pointeur Null et un numéro d’erreur spécifique peut être récupéré en appelant WSAGetLastError.

Code d'erreur Signification
WSANOTINITIALISED
 Un appel WSAStartup réussi doit se produire avant d’utiliser cette fonction.
WSAENETDOWN
 Le sous-système réseau a échoué.
WSAHOST_NOT_FOUND
 Service de réponse faisant autorité introuvable.
WSATRY_AGAIN
 Un service non authentifié introuvable ou une défaillance du serveur.
WSANO_RECOVERY
 Erreurs non récupérables, la base de données des services n’est pas accessible.
WSANO_DATA
 Nom valide, aucun enregistrement de données de type demandé.
WSAEINPROGRESS
 Un appel Windows Sockets 1.1 bloquant est en cours ou le fournisseur de services traite toujours une fonction de rappel.
WSAEINTR
 Un appel Windows Socket 1.1 bloquant a été annulé via WSACancelBlockingCall.

Remarques

La fonction getservbyname retourne un pointeur vers la structure de service contenant le ou les noms et le numéro de service qui correspondent à la chaîne dans le paramètre name . Toutes les chaînes sont terminées par un caractère Null.

Le pointeur retourné pointe vers la structure de service allouée par la bibliothèque Windows Sockets. L’application ne doit jamais tenter de modifier cette structure ou de libérer aucun de ses composants. En outre, une seule copie de cette structure est allouée par thread. L’application doit donc copier toutes les informations dont elle a besoin avant d’émettre d’autres appels de fonction Windows Sockets.

Windows Phone 8 : cette fonction est prise en charge pour les applications Windows Phone Store sur Windows Phone 8 et versions ultérieures.

Windows 8.1 et Windows Server 2012 R2 : cette fonction est prise en charge pour les applications du Windows Store sur Windows 8.1, Windows Server 2012 R2 et versions ultérieures.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 8.1, Windows Vista [applications de bureau | Applications UWP]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau | applications UWP]
Plateforme cible Windows
En-tête winsock.h (inclure Winsock2.h)
Bibliothèque Ws2_32.lib
DLL Ws2_32.dll

Voir aussi

WSAAsyncGetServByName

Winsock Functions

Référence Winsock

getservbyport