SocketTlsHandshake

TLS Tokalaşma protokolü aracılığıyla belirli bir ana bilgisayara güvenli TLS (SSL) bağlantısı kurar. Tokalaşma sırasında, bir müşteri ve bir sunucu bağlantı parametreleri üzerinde hemfikir olur: uygulanan protokol sürümü ve veri şifreleme yöntemi.

bool  SocketTlsHandshake(
   int           socket,               // soket
   const string  host                  // ana bilgisayar adresi
   );

Parametreler

socket

[in] SocketCreate fonksiyonu tarafından geri döndürülen soket tanıtıcı değeri. Yanlış bir tanıtıcı değeri iletildiğinde; hata 5270 (ERR_NETSOCKET_INVALIDHANDLE), _LastError'a yazılır.

host

[in]  Güvenli bir bağlantı kurulan sunucunun adresi.

Geri dönüş değeri

Başarılı olursa true, aksi takdirde false olarak geri döner.

Not

Güvenli bir bağlantıdan önce, program SocketConnect kullanarak ana bilgisayarla standart bir TCP bağlantısı kurmalıdır.

Güvenli bağlantı başarısız olursa; hata 5274 (ERR_NETSOCKET_HANDSHAKE_FAILED), _LastError'a yazılır.

443 numaralı bağlantı noktasına bağlanırken fonksiyonu çağırmanıza gerek yoktur. Bu, güvenli TLS (SSL) bağlantıları için kullanılan standart bir TCP bağlantı noktasıdır.

Fonksiyon, yalnızca kendi yürütme iş parçacıklarında çalışan Uzman Danışmanlardan ve komut dosyalarından çağrılabilir. Bir göstergeden çağrılırsa; GetLastError(), 4014 hatasını geri döndürür - "Çağırma için fonksiyona izin verilmiyor".