Freigeben über


CAsyncSocket::Bind

Rufen Sie die Memberfunktion auf, um eine lokale Adresse mit dem Socket zuzuordnen.

BOOL Bind(
   UINT nSocketPort,
   LPCTSTR lpszSocketAddress = NULL 
);
BOOL Bind (
   const SOCKADDR* lpSockAddr,
   int nSockAddrLen 
);

Parameter

  • nSocketPort
    Der Port, der die Socket-Anwendung identifiziert.

  • lpszSocketAddress
    Die Netzwerkadresse, ein durch Punkte getrennte Zahl wie "128.56.22.8".Die NULL Zeichenfolge für diesen Parameter übergeben wird, gibt die CAsyncSocket-Instanz sollte auf Clientaktivität auf allen Netzwerkschnittstellen überwachen an.

  • lpSockAddr
    Ein Zeiger auf eine SOCKADDR-Struktur, die die Adresse, um zu diesem Socket zuzuweisen.

  • nSockAddrLen
    Die Länge der Adresse in lpSockAddr in Bytes.

Rückgabewert

Ungleich 0 (null), wenn die Funktion erfolgreich; andernfalls 0 und ein bestimmter Fehlercode können abgerufen werden, indem Sie GetLastError aufruft.Die folgenden Fehler gelten für diese Memberfunktion zu:

  • Vor der Verwendung dieser APIs WSANOTINITIALISED einem erfolgreichen AfxSocketInit muss auftreten.

  • WSAENETDOWN, das die Windows Socket-Implementierung hat, dass das Netzwerksubsystem fehlgeschlagen ist.

  • WSAEADDRINUSE die angegebene Adresse ist bereits verwendet.(Siehe die SO_REUSEADDR Socketoption unter SetSockOpt.)

  • WSAEFAULT das nSockAddrLen-Argument ist zu klein (kleiner als die Größe einer SOCKADDR-Struktur).

  • Ist blockierenden Windows Socket-Aufruf WSAEINPROGRESS A ausgeführt.

  • WSAEAFNOSUPPORT die angegebene Adressenfamilie wird nicht von diesen Port unterstützt.

  • WSAEINVAL der Socket ist bereits auf einer Adresse gebunden.

  • WSAENOBUFS nicht genug puffert verfügbar, zu viele Verbindungen.

  • WSAENOTSOCK der Deskriptor ist kein Socket.

Hinweise

Diese Routine wird auf einem unverbundenen Datagramm oder einem Streamsocket, bevor nachfolgendes Verbinden oder Listen Aufrufe verwendet.Bevor sie Aufforderungen zum Aufbau einer Verbindung akzeptieren kann, muss ein lauschender Serversocket Anschlussnummer auswählen und sie ausführen wird Windows Sockets, indem er Bind aufruft.Bind bildet die lokale Zuordnung (host IP-Adressen/Portnummer) des Sockets, indem es einen lokalen Namen zu einem unbenannten Socket zuweist.

Anforderungen

Header: afxsock.h

Siehe auch

Referenz

CAsyncSocket-Klasse

Hierarchien-Diagramm

CAsyncSocket::Connect

CAsyncSocket::Listen

CAsyncSocket::GetSockName

CAsyncSocket::SetSockOpt

CAsyncSocket::Create