SckInfo

obj -> SckInfo(int1[, int2]) : alpha

Socket-Informationen abfragen/setzen

Details

• obj: Socket-Deskriptor
• int1: Informationstyp (siehe Text)
• int2: optionaler Wert (optional)
• Resultat: alpha Informationen
• Siehe: Verwandte Befehle

Mit diesem Befehl können Informationen über die Socket-Verbindung abgefragt oder gesetzt werden. In (obj) wird der Socket-Deskriptor übergeben.

info

In der Beispiel-Datenbank "CodeLibrary" befindet sich ein Beispiel zur Kommunikation mit einem FTP-Server.

Folgende Informationen können ermittelt werden:

• Option (int1): zurückgegebene Information
• _SckAddrLocal: lokale IP-Adresse
• _SckAddrPeer: IP-Adresse des Zielhosts
• _SckCertificateCN: "Common Name" des serverseitigen Zertifikats
• _SckHostName: lokaler Hostname
• _SckPortLocal: lokaler IP-Port
• _SckPortPeer: IP-Port des Zielhosts
• _SckVersionTLS: verwendete TLS-Version bei verschlüsselter Verbindung
• _SckVol: übertragene Datenvolumen in Bytes
• _SckVolRead: empfangene Datenvolumen in Bytes
• _SckVolWrite: gesendete Datenvolumen in Bytes
• _SckReadyRead: Ermitteln ob Daten zum Lesen vorhanden
• _SckTimeout: Ermitteln / Setzen des Timeout
• _SckKeepAlive: Ermitteln / Setzen der Keep-Alive-Zeit
• _SckDefaultKeepAlive: Setzen der Keep-Alive-Zeit auf den eingestellten Vorgabewert (siehe SOA-Service - Konfigurationsdatei )

Wird mit _SckVersionTLS die TLS-Version einer verschlüsselten Verbindung ermittelt, wird Version gefolgt von einem Leerzeichen und der verwendeten Cipher-Suite zurückgegeben. Folgende Versionen können zurückgegeben werden.

• '': keine verschlüsselte Verbindung
• 'SSLv3': Verschlüsselt mit SSL 3.0
• 'TLSv1': Verschlüsselt mit TLS 1.0
• 'TLSv1.1': Verschlüsselt mit TLS 1.1
• 'TLSv1.2': Verschlüsselt mit TLS 1.2

Wird bei einer verschlüsselten Verbindung das Server-Zertifikat überprüft (siehe _SckOptVerify) muss anschließend geprüft werden, ob das Zertifikat auch für den verbundenen Server ausgestellt wurde. Mit tSck-> SckInfo ( _SckCertificateCN ) wird der "Common Name" aus dem Zertifikat ermittelt und kann mit dem Hostnamen verglichen werden. Da der "Common Name" Wildcards beinhalten kann, muss ein Ähnlichkeitsvergleich durchgeführt werden (siehe _SckCertificateCN).

Wird in (int1) _SckReadyRead angegeben, muss in (int2) eine Wartezeit in Millisekunden angegeben werden. Sind bis zu diesem Zeitpunkt keine Daten vorhanden, wird _ErrTimeout zurückgegeben. Sind Daten vorhanden wird '0' zurückgegeben.

Sofern der Deskriptor (obj) nicht definiert ist oder keinen Socket bezeichnet, erfolgt der Laufzeitfehler (_ErrHdlInvalid).