getservbyname, fonction (winsock2.h)
La fonction getservbyname récupère les informations de service correspondant à un nom de service et à un protocole.
Syntaxe
servent *WSAAPI 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 s_name membre de la structure des services ou au membre s_aliases de la structure du service . Sinon, getservbyname correspond à la fois au nom et au proto.
Valeur retournée
Si aucune erreur ne se produit, getservbyname retourne un pointeur vers la structure du service . Sinon, il retourne un pointeur null et un numéro d’erreur spécifique peut être récupéré en appelant WSAGetLastError.
| Code d'erreur | Signification |
|---|---|
| Un appel WSAStartup réussi doit se produire avant d’utiliser cette fonction. | |
| Le sous-système réseau a échoué. | |
| Service de réponse faisant autorité introuvable. | |
| Service non authentifié introuvable ou défaillance du serveur. | |
| Erreurs irrécupérables, la base de données des services n’est pas accessible. | |
| Nom valide, aucun enregistrement de données du type demandé. | |
| Un appel bloquant Windows Sockets 1.1 est en cours ou le fournisseur de services traite toujours une fonction de rappel. | |
| Un appel bloquant Windows Socket 1.1 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 correspondant à la chaîne dans le paramètre name . Toutes les chaînes sont terminées par 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 Sockets Windows.
Windows Phone 8 : cette fonction est prise en charge pour les applications du Store Windows Phone 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 | winsock2.h (inclure Winsock2.h) |
| Bibliothèque | Ws2_32.lib |
| DLL | Ws2_32.dll |