CAsyncSocket::GetSockName

Article
03/04/2013

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