SocketTlsHandshake

Initiieren einer sicheren (SSL) Verbindung mit einem angegebenen Host über das Protokoll TLS-Handshake Während des Handshakes vereinbaren Client und Server die Verbindungsparameter: das zu verwendende Protokoll und die Verschlüsselungsmethode.

bool  SocketTlsHandshake(
   int           socket,               // Socket
   const string  host                  // Adresse des Hosts
   );

Parameter

socket

[in]  Handle des Sockets, das von der Funktion SocketCreate erzeugt worden war. Wurde ein ungültiger Handle übergeben wird, wird der Fehler 5270 (ERR_NETSOCKET_INVALIDHANDLE) der Variablen _LastError zugewiesen.

host

[in]  Adresse des Hosts, mit dem die sichere Verbindung hergestellt werden soll.

Rückgabewert

Gibt true im Erfolgsfall zurück, andernfalls false.

Hinweis

Vor einer sicheren Verbindung sollte das Programm eine standardmäßige TCP-Verbindung mit dem Host über SocketConnect aufbauen.

Kommt keine die sichere Verbindung zustande, wird der Fehler 5274 (ERR_NETSOCKET_HANDSHAKE_FAILED) der Variablen _LastError zugewiesen.

Es ist nicht notwendig, bei einer Verbindung zum Port 443 diese Funktion aufzurufen. Dies ist ein standardmäßiger TCP-Port, der für sichere (SSL) TLS-Verbindungen verwendet wird.

Die Funktion kann nur von Expert Advisors und Skripten aufgerufen werden, da sie in ihrem eigenen Ausführungsthread laufen. Wenn sie ein Indikator aufruft, wird von GetLastError() der Fehler 4014 – "Funktionsaufruf ist nicht erlaubt" ausgeworfen.