Getprotobynumber, fonction (winsock2.h)
La fonction getprotobynumber récupère les informations de protocole correspondant à un numéro de protocole.
Syntaxe
protoent *WSAAPI getprotobynumber(
[in] int number
);
Paramètres
[in] number
Numéro de protocole, dans l’ordre d’octet de l’hôte.
Valeur retournée
Si aucune erreur ne se produit, getprotobynumber retourne un pointeur vers la structure protoente . 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 |
|---|---|
| Un appel WSAStartup réussi doit se produire avant d’utiliser cette fonction. | |
| Le sous-système réseau a échoué. | |
| Protocole de réponse faisant autorité introuvable. | |
| Protocole non authentifié introuvable ou défaillance du serveur. | |
| Erreurs non récupérables, la base de données protocoles n’est pas accessible. | |
| Nom valide, aucun enregistrement de données de type demandé. | |
| Un appel Windows Sockets 1.1 bloquant est en cours ou le fournisseur de services traite toujours une fonction de rappel. | |
| Un appel Windows Socket 1.1 bloquant a été annulé via WSACancelBlockingCall. |
Remarques
Cette fonction getprotobynumber retourne un pointeur vers la structure protoente , comme décrit précédemment dans getprotobyname. Le contenu de la structure correspond au numéro de protocole donné.
Le pointeur retourné pointe vers la structure allouée par 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 | winsock2.h (inclure Winsock2.h) |
| Bibliothèque | Ws2_32.lib |
| DLL | Ws2_32.dll |