System.Net.Socket.TSocket.InitSocket

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

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);

Eigenschaften

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


Beschreibung

Gibt eine sockaddr_in-Struktur zurück, die auf Basis der angegebenen Parameter konfiguriert ist.

InitSocket legt die Socket-Adresse je nach den angegebenen Argumenten unterschiedlich fest:

  • Wenn Name kein leerer String ist, führt InitSocket eine DNS-Suche des angegebenen Strings durch.
  • Wenn Address kein leerer String ist, verwendet InitSocket diese Adresse. Address muss eine IPv4-Adresse sein. Zum Beispiel: "192.0.2.4".
  • Wenn Ihr Socket ein Broadcast-Socket (Broadcast ist True) oder ein Server-Socket ist (Client ist False), müssen Sie keine Adresse angeben.

InitSocket legt auch den Socket-Port je nach den angegebenen Argumenten unterschiedlich fest:

  • Wenn Service kein leerer String ist, sucht InitSocket den Port, der mit dem angegebenen Dienstnamen übereinstimmt.
  • Ansonsten verwendet InitSocket den Wert, den Sie für den Parameter Port angegeben haben.

Exceptions

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

Exception Exception.Message Szenarien

ESocketError

Keine Adresse angegeben

  • Sie haben zu wenig Informationen angegeben, um die Adresse des Socket festzulegen. InitSocket löst diese Exception aus, wenn Name und Address leere Strings sind; Broadcast ist False und Client ist True.

Siehe auch