Udostępnij za pośrednictwem


CAsyncSocket::GetSockName

Wywołanie tej funkcji Członkowskich uzyskać lokalnej nazwy dla gniazda.

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

Parametry

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

  • rSocketPort
    Odniesienie do UINT przechowujący portu.

  • lpSockAddr
    Wskaźnik do SOCKADDR strukturę, która odbierze adres gniazda.

  • lpSockAddrLen
    Wskaźnik długość adresu w lpSockAddr 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 jest wykonywana operacja blokująca Windows Sockets.

  • WSAENOTSOCK deskryptora nie jest gniazdem.

  • WSAEINVAL gniazda nie został powiązany z adresem powiązania.

Uwagi

To wywołanie jest szczególnie przydatna, gdy Połącz wywołanie zostało wykonane bez zaawansowana powiązania pierwszy; to wywołanie zawiera tylko środki, w którym można określić lokalnej stowarzyszenie, które ustawiono w systemie.

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

Wymagania

Nagłówek: afxsock.h

Zobacz też

Informacje

Klasa CAsyncSocket

Diagram hierarchii

CAsyncSocket::Bind

CAsyncSocket::Create

CAsyncSocket::GetPeerName