System.Net.Socket.TSocket.Listen

• Übergeordnet: TSocket

Delphi

procedure Listen(const Address, Service: string; Port: Word; QueueSize: Integer = -1); overload;
procedure Listen(const Endpoint: TNetEndpoint; QueueSize: Integer = -1); overload;

C++

void __fastcall Listen(const System::UnicodeString Address, const System::UnicodeString Service, System::Word Port, int QueueSize = 0xffffffff)/* overload */;
void __fastcall Listen(const TNetEndpoint &Endpoint, int QueueSize = 0xffffffff)/* overload */;

Eigenschaften

Typ	Sichtbarkeit	Quelle	Unit	Übergeordnet
procedure function	public	System.Net.Socket.pas System.Net.Socket.hpp	System.Net.Socket	TSocket

Beschreibung

Konfiguriert den Socket so, dass das Akzeptieren von eingehenden Verbindungen gestartet wird.

Nach einem Aufruf von Listen müssen Sie Accept aufrufen, um eine eingehende Verbindung tatsächlich zu akzeptieren und einen Kommunikationskanal zum Client einzurichten.

Um den Endpunkt anzugeben, über den Ihr Socket empfängt, müssen Sie eine der folgenden Parameterkombinationen angeben:

• Einen Endpunkt (Endpoint).
• Eine IP-Adresse (Address) und einen Dienst (Service). Sie können als Port ein leeres Wort übergeben, da mit Service der Port ermittelt wird.
• Eine IP-Adresse (Address) und einen Port (Port). Übergeben Sie als Service einen leeren String, ansonsten wird mit dem angegebenen Dienstnamen der zu verwendende Port ermittelt, und der angegebene Port wird ignoriert.

QueueSize legt die maximale Länge der Warteschlange der ausstehenden Verbindungen fest. Siehe die Funktion listen auf der MSDN-Website. Verwenden Sie -1 als die maximale empfohlene Länge der Warteschlange (Vorgabe).

Exceptions

Ein Aufruf von Bind kann eine der folgenden Exceptions auslösen:

Exception	Exception.Message	Szenarien
ESocketError	Es kann kein neuer Socket erstellt werden	Windows konnte keinen Socket mit dem angeforderten Typ erstellen. Weitere Informationen finden Sie unter Funktion socket (MSDN).
	Ein geöffneter Socket kann nicht überwacht werden	Sie können über einen bereits geöffneten Socket nicht empfangen. Der Socket muss bereits durch einen vorhergehenden Aufruf der folgenden Methoden geöffnet worden sein: Bind Connect Create (wenn Sie ein Socket-Handle und eine Socket-Adresse angegeben haben) GetClientSocket Listen ListenBroadcast OpenBroadcast
	Netzwerk-Socket-Fehler: <Fehlermeldung> (<Fehlercode>) bei API "bind"	Das Betriebssystem hat beim Binden Ihres Socket an eine lokale IP-Adresse einen Fehler gemeldet. Dies kann nur vorkommen, wenn der Typ Ihres Socket UDP ist. Weitere Informationen finden Sie in der folgenden Dokumentation für das Betriebssystem, auf dem Ihre Anwendung ausgeführt wurde: Windows: Funktion bind (MSDN) OS X: bind (OS X Man Pages) iOS: bind (iOS Manual Pages) Android: bind (Linux Programmer's Manual) Linux: bind (Linux Programmer's Manual)
	Netzwerk-Socket-Fehler: <Fehlermeldung> (<Fehlercode>) bei API "listen"	Das Betriebssystem hat beim Konfigurieren Ihres Socket für den Empfang eingehender Verbindungen einen Fehler gemeldet. Dies kann nur vorkommen, wenn der Typ des Socket nicht UDP ist. Weitere Informationen finden Sie in der folgenden Dokumentation für das Betriebssystem, auf dem Ihre Anwendung ausgeführt wurde: Windows: Funktion listen (MSDN) OS X: listen (OS X Man Pages) iOS: listen (iOS Manual Pages) Android: listen (Linux Programmer's Manual) Linux: listen (Linux Programmer's Manual)
	Netzwerk-Socket-Fehler: <Fehlermeldung> (<Fehlercode>) bei API "socket"	Das Betriebssystem hat beim Erstellen eines Socket einen Fehler gemeldet. Weitere Informationen finden Sie in der folgenden Dokumentation für das Betriebssystem, auf dem Ihre Anwendung ausgeführt wurde: Windows: Funktion socket (MSDN) OS X: socket (OS X Man Pages) iOS: socket (iOS Manual Pages) Android: socket (Linux Programmer's Manual) Linux: socket (Linux Programmer's Manual)

Siehe auch

• System.Net.Socket.TSocket.Accept

• System.Net.Socket.TNetEndpoint
• System.Net.Socket.TSocket.LookupService

• System.Net.Socket.TSocket.ListenBroadcast

• System.Net.Socket.TSocket.CreateSocket
• System.Net.Socket.TSocket.DoBind

• Funktion listen