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


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