System.Net.Socket.TSocket.InitSocket

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

function InitSocket(const Name, Address, Service: string; Port: Word; Client: Boolean; Broadcast: Boolean = False): sockaddr_in;

C++

sockaddr_in __fastcall InitSocket(const System::UnicodeString Name, const System::UnicodeString Address, const System::UnicodeString Service, System::Word Port, bool Client, bool Broadcast = false);

Propriétés

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


Description

Renvoie une structure sockaddr_in (EN) configurée en fonction des paramètres spécifiés.

InitSocket détermine différemment l'adresse du socket selon les arguments spécifiés :

  • Si Name n'est pas une chaîne vide, InitSocket effectue une recherche DNS de la chaîne spécifiée.
  • Si Address n'est pas une chaîne vide, InitSocket utilise cette adresse. Address doit être une adresse IPv4. Par exemple : "192.0.2.4".
  • Si votre socket est un socket de diffusion (Broadcast à True) ou un socket serveur (Client à False), il n'est pas nécessaire de spécifier une adresse.

InitSocket détermine différemment le port du socket selon les arguments spécifiés :

  • Si Service n'est pas une chaîne vide, InitSocket recherche le port correspondant au nom de service spécifié.
  • Sinon, InitSocket utilise la valeur que vous spécifiez pour le paramètre Port.

Exceptions

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

Exception Exception.Message Scénarios

ESocketError

Aucune adresse spécifiée

  • Vous n'avez pas spécifié assez d'informations pour déterminer l'adresse du socket. InitSocket déclenche cette exception lorsque Name et Address sont des chaînes vides ; Broadcast à False et Client à True.

Voir aussi