Partager via


CAsyncSocket::GetSockName

Appelez la fonction membre pour obtenir le nom local pour un socket.

BOOL GetSockName( 
   CString& rSocketAddress, 
   UINT& rSocketPort  
); 
BOOL GetSockName( 
   SOCKADDR* lpSockAddr, 
   int* lpSockAddrLen  
);

Paramètres

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

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

  • lpSockAddr
    Un pointeur vers une structure de SOCKADDR qui accepte l'adresse du socket.

  • lpSockAddrLen
    Un pointeur à la longueur de l'adresse dans lpSockAddr 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'exécution de Windows Sockets est en cours.

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

  • WSAEINVAL le socket n'a pas été lié à une adresse avec Liaison.

Notes

Cet appel est particulièrement utile lorsqu'un appel de Connecter a été effectué sans effectuer Liaison d'abord ; cet appel fournit les seuls moyens par lesquels vous pouvez déterminer l'association locale définie par le système.

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

Configuration requise

Header: afxsock.h

Voir aussi

Référence

CAsyncSocket, classe

Graphique de la hiérarchie

CAsyncSocket::Bind

CAsyncSocket::Create

CAsyncSocket::GetPeerName