Поделиться через


CAsyncSocket::GetPeerName

Эта функция-член вызывается с целью получить адрес сокета однорангового узла, к которому этот сокет подключено.

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

Параметры

  • rPeerAddress
    Ссылка на объект, который получает CString пунктирная IP-адрес числа.

  • rPeerPort
    Ссылка на UINT, которая хранит порт.

  • lpSockAddr
    Указатель на структуру SOCKADDR сокета, которая возвращает имя однорангового узла.

  • lpSockAddrLen
    Указатель на длину адресов в lpSockAddr в байтах. По возвращении аргумент lpSockAddrLen содержит фактический размер lpSockAddr, возвращенных в байтах.

Возвращаемое значение

Ненулевой если функция успешно; в противном случае – значение 0, а конкретный код ошибки могут быть восстановлены путем вызова GetLastError. Об ошибке применяемых к данному функции-члену.

  • WSANOTINITIALISED А успешное AfxSocketInit должно произойти перед использованием этого API.

  • Реализация Windows WSAENETDOWN sockets обнаружила, что подсистема сети.

  • WSAEFAULT Аргумент lpSockAddrLen не настолько велико.

  • Блокирующий вызов sockets WSAEINPROGRESS a Windows.

  • WSAENOTCONN Сокет не подключено.

  • Не WSAENOTSOCK дескриптор сокета.

Заметки

Чтобы обрабатывать адреса IP версии 6, используйте CAsyncSocket::GetPeerNameEx.

Требования

Header: afxsock.h

См. также

Ссылки

Класс CAsyncSocket

Диаграмма иерархии

CAsyncSocket::Bind

CAsyncSocket::Connect

CAsyncSocket::Create

CAsyncSocket::GetSockName