Partager via


CAsyncSocket::GetPeerName

Appelez la fonction membre pour obtenir l'adresse du socket homologue auquel ce socket est connecté.

BOOL GetPeerName( 
   CString& rPeerAddress, 
   UINT& rPeerPort  
); 
BOOL GetPeerName( 
   SOCKADDR* lpSockAddr, 
   int* lpSockAddrLen  
);

Paramètres

  • rPeerAddress
    Référence à un objet d' CString qui accepte une adresse IP du nombre de valeurs séparées par des points.

  • rPeerPort
    Référence à uint qui enregistre un port.

  • lpSockAddr
    Un pointeur vers une structure de SOCKADDR qui accepte le nom du socket homologue.

  • lpSockAddrLen
    Un pointeur à la longueur de l'adresse dans lpSockAddr en octets. Au retour, l'argument d' lpSockAddrLen contient la grandeur réelle de lpSockAddr retournées en octets.

Valeur de retour

Une valeur différente de zéro si la fonction est réussie ; sinon 0, et le code d'erreur spécifique peuvent être récupérés en appelant GetLastError. Les erreurs suivantes s'appliquent à cette fonction membre :

  • WSANOTINITIALISED A réussi AfxSocketInit doit se produire avant d'utiliser cette API.

  • WSAENETDOWN que l'implémentation de Windows Sockets l'a détecté que le sous-système réseau a échoué.

  • WSAEFAULT l'argument d' lpSockAddrLen n'est pas assez grand.

  • WSAEINPROGRESS se bloque l'appel de Windows Sockets est en cours.

  • WSAENOTCONN le socket n'est pas connecté.

  • WSAENOTSOCK le modèle n'est pas un socket.

Notes

Pour gérer des adresses de IPv6, utilisez CAsyncSocket::GetPeerNameEx.

Configuration requise

Header: afxsock.h

Voir aussi

Référence

CAsyncSocket, classe

Graphique de la hiérarchie

CAsyncSocket::Bind

CAsyncSocket::Connect

CAsyncSocket::Create

CAsyncSocket::GetSockName