System.Net.Socket.TSocket.Listen

• Aller au parent : 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 */;

Propriétés

Type	Visibilité	Source	Unité	Parent
procedure function	public	System.Net.Socket.pas System.Net.Socket.hpp	System.Net.Socket	TSocket

Description

Configure le socket pour commencer à accepter des connexions entrantes.

Après l'appel à Listen, vous devez appeler Accept pour accepter effectivement une connexion entrante et établir un canal de communication avec ce client.

Pour spécifier le point de terminaison sur lequel votre socket écoute, vous devez fournir l'une ou l'autre des combinaisons de paramètres suivantes :

• Un point de terminaison (Endpoint).
• Une adresse IP (Address) et un service (Service). Vous pouvez transmettre un mot vide en tant que Port, car Service est utilisé pour déterminer le port.
• Une adresse IP (Address) et un port (Port). Transmettez une chaîne vide en tant que Service, sinon le nom de service spécifié est utilisé pour déterminer le port à utiliser, et le port spécifié est ignoré.

QueueSize détermine la longueur maximale de la file d'attente des connexions en attente. Voir la fonction listen (EN) sur MSDN. Utilisez -1 pour la longueur maximale recommandée de la file d'attente (par défaut).

Exceptions

Un appel à Bind peut déclencher l'une des exceptions suivantes :

Exception	Exception.Message	Scénarios
ESocketError	Impossible de créer un nouveau socket	La création par Windows d'un socket du type requis a échoué. Pour de plus amples informations, voir fonction socket (EN) (MSDN).
	Impossible d'écouter sur un socket ouvert	Vous ne pouvez pas écouter sur un socket qui est déjà ouvert. Un appel précédent à l'une des méthodes suivantes doit avoir déjà ouvert le socket : Bind Connect Create (si vous spécifiez un handle de socket et une adresse de socket) GetClientSocket Listen ListenBroadcast OpenBroadcast
	Erreur de socket réseau : <message d'erreur> (<code d'erreur>), sur la fonction 'bind' de l'API	Le système d'exploitation a signalé une erreur lors de la liaison de votre socket à une adresse IP locale. Cela peut uniquement se produire si le type du socket est UDP. Pour de plus amples informations, voir la documentation suivante relative au système d'exploitation sur lequel votre application était exécutée : Windows : fonction bind (EN) (MSDN) OS X: bind (OS X Man Pages) (EN) iOS : bind (iOS Manual Pages) (EN) Android : bind (Linux Programmer's Manual) (EN) Linux: bind (Linux Programmer's Manual) (EN)
	Erreur de socket réseau : <message d'erreur> (<code d'erreur>), sur la fonction 'listen' de l'API	Le système d'exploitation a signalé une erreur lors de la configuration de votre socket pour l'écoute des connexions entrantes. Cela peut uniquement se produire si le type du socket n'est pas UDP. Pour de plus amples informations, voir la documentation suivante relative au système d'exploitation sur lequel votre application était exécutée : Windows : fonction listen (EN) (MSDN) OS X: listen (OS X Man Pages) (EN) iOS : listen (iOS Manual Pages) (EN) Android : listen (Linux Programmer's Manual) (EN) Linux: listen (Linux Programmer's Manual) (EN)
	Erreur de socket réseau : <message d'erreur> (<code d'erreur>), sur la fonction 'socket' de l'API	Le système d'exploitation a signalé une erreur lors de la création d'un socket. Pour de plus amples informations, voir la documentation suivante relative au système d'exploitation sur lequel votre application était exécutée : Windows : fonction socket (EN) (MSDN) OS X: socket (OS X Man Pages) (EN) iOS : socket (iOS Manual Pages) (EN) Android : socket (Linux Programmer's Manual) (EN) Linux: socket (Linux Programmer's Manual) (EN)

Voir aussi

• 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

• fonction listen (EN)