getprotobynumber, fonction (winsock.h)

Article
08/27/2023

La fonction getprotobynumber récupère les informations de protocole correspondant à un numéro de protocole.

Syntaxe

protoent * getprotobynumber(
  int proto
);

Paramètres

proto

TBD

Valeur retournée

Si aucune erreur ne se produit, getprotobynumber retourne un pointeur vers la structure protoente . 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
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	Protocole de réponse faisant autorité introuvable.
WSATRY_AGAIN	Protocole non authentifié introuvable ou défaillance du serveur.
WSANO_RECOVERY	Erreurs irrécupérables, la base de données des protocoles n’est pas accessible.
WSANO_DATA	Nom valide, aucun enregistrement de données du type demandé.
WSAEINPROGRESS	Un appel bloquant Windows Sockets 1.1 est en cours ou le fournisseur de services traite toujours une fonction de rappel.
WSAEINTR	Un appel bloquant Windows Socket 1.1 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 les sockets Windows. 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 étant allouée par thread, l’application doit 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	winsock.h (inclure Winsock2.h)
Bibliothèque	Ws2_32.lib
DLL	Ws2_32.dll

Voir aussi

WSAsyncGetProtoByNumber

Fonctions Winsock

Informations de référence sur Winsock

getprotobyname