Fonction de rappel LPWSPGETPEERNAME (ws2spi.h)
La fonction LPWSPGetPeerName obtient l’adresse de l’homologue auquel un socket est connecté.
Syntaxe
LPWSPGETPEERNAME Lpwspgetpeername;
int Lpwspgetpeername(
[in] SOCKET s,
[out] sockaddr *name,
[in, out] LPINT namelen,
[out] LPINT lpErrno
)
{...}
Paramètres
[in] s
Descripteur identifiant un socket connecté.
[out] name
Pointeur vers la structure sockaddr pour recevoir le nom de l’homologue.
[in, out] namelen
Lors de l’entrée, pointeur vers un entier qui indique la taille de la structure pointée par nom, en octets. Sur la sortie, indique la taille du nom retourné, en octets.
[out] lpErrno
Pointeur vers le code d’erreur.
Valeur retournée
Si aucune erreur ne se produit, LPWSPGetPeerName retourne zéro. Sinon, la valeur SOCKET_ERROR est retournée et un code d’erreur spécifique est disponible dans lpErrno.
| Code d'erreur | Signification |
|---|---|
| Le sous-système réseau a échoué. | |
| Le paramètre name ou namelen ne fait pas partie de l’espace d’adressage de l’utilisateur ou le paramètre namelen est trop petit. | |
| La fonction est appelée lorsqu’un rappel est en cours. | |
| Le descripteur n’est pas un socket. | |
| Le socket n'est pas connecté. | |
| Le descripteur n’est pas un socket. |
Remarques
La fonction LPWSPGetPeerName fournit le nom de l’homologue connecté aux sockets et le stocke dans la structure sockaddr référencée par nom. Il peut être utilisé uniquement sur un socket connecté. Pour les sockets de datagramme, seul le nom d’un homologue spécifié dans un appel LPWSPConnect précédent est retourné et tout nom spécifié par un appel LPWSPSendTo précédent ne sera pas retourné par LPWSPGetPeerName.
Lors du retour, le paramètre namelen contient la taille réelle du nom retourné en octets.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| En-tête | ws2spi.h |