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)

Siehe auch

AERROR( ) | SQLCONNECT( ) | SQLSETPROP( )