SQLGETPROP( )-Funktion
Gibt aktuelle Einstellungen oder Standardeinstellungen für eine aktive Verbindung zurück.
SQLGETPROP(nConnectionHandle, cSetting)
Rückgabewerte
Zeichen, Numerisch oder Logisch
Parameter
- nConnectionHandle
Gibt das Verbindungshandle der Datenquelle an, das von SQLCONNECT( ) zurückgegeben wird. Wenn Sie für nConnectionHandle 0 angeben, gibt SQLGETPROP( ) die Umgebungseinstellung zurück. - cSetting
Gibt die Einstellung an. Eine Liste der Einstellungen, die Sie angeben können, finden Sie unter SQLSETPROP( ).
Hinweise
Beim Auftreten eines Fehlers auf Verbindungsebene wird -1 zurückgegeben. Beim Auftreten eines Fehlers auf Umgebungsebene wird -2 zurückgegeben.
Beispiel
Im folgenden Beispiel wird das Verbindungsdialogfeld mit SQLCONNECT( ) angezeigt. Wählen Sie nun eine Datenquelle aus. Im Beispiel werden die Ergebnisse mit der SQLGETPROP( )-Funktion und der DataSource cSetting angezeigt.
* Clear environment
CLOSE ALL
CLEAR ALL
CLEAR
* Display the Select Connection or Data Source dialog box
* to choose a connection
nHandle=SQLCONNECT()
* Test connection, report results
IF nHandle > 0
cSource= SQLGETPROP(nHandle, "datasource")
=MESSAGEBOX("Current Data Source = "+cSource,0,"Connection Results")
ELSE
=MESSAGEBOX("Connection Error = " + ;
ALLTRIM(STR(nHandle)),0,"Connection Results")
ENDIF
=SQLDISCONNECT(nHandle)