Udostępnij za pośrednictwem


CAsyncSocket::GetPeerName

Wywołanie tej funkcji Członkowskich uzyskać adresu gniazda peer, do którego podłączony jest tego gniazda.

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

Parametry

  • rPeerAddress
    Odniesienie do CString obiekt, który odbiera kropkowane numerem adresu IP.

  • rPeerPort
    Odniesienie do UINT przechowujący portu.

  • lpSockAddr
    Wskaźnik do SOCKADDR strukturę, która otrzyma nazwę gniazda elementów równorzędnych.

  • lpSockAddrLen
    Wskaźnik długość adresu w lpSockAddr w bajtach.Na powrót lpSockAddrLen argument zawiera rzeczywisty rozmiar lpSockAddr zwracany w bajtach.

Wartość zwracana

Niezerowa, jeśli funkcja jest pomyślne; w przeciwnym razie 0 i kod błędu mogą być pobierane przez wywołanie GetLastError.Do tej funkcji Członkowskich stosuje się następujące błędy:

  • WSANOTINITIALISED pomyślnie AfxSocketInit musi wystąpić przed użyciem tego interfejsu API.

  • WSAENETDOWN implementacja Windows Sockets wykrył, że podsystem sieci nie powiodło się.

  • WSAEFAULTlpSockAddrLen argument nie jest wystarczająco duży.

  • WSAEINPROGRESS trwa blokowania wywołanie Windows Sockets.

  • WSAENOTCONN gniazdo nie jest podłączony.

  • WSAENOTSOCK deskryptora nie jest gniazdem.

Uwagi

Aby obsługiwać adresy IPv6, należy użyć CAsyncSocket::GetPeerNameEx.

Wymagania

Nagłówek: afxsock.h

Zobacz też

Informacje

Klasa CAsyncSocket

Diagram hierarchii

CAsyncSocket::Bind

CAsyncSocket::Connect

CAsyncSocket::Create

CAsyncSocket::GetSockName