SQLGETPROP( ) (Función)
Devuelve la configuración actual o predeterminada para una conexión activa.
SQLGETPROP(nConnectionHandle, cSetting)
Valores devueltos
Character, Numeric o Logical
Parámetros
- nConnectionHandle
Especifica el identificador de conexión al origen de datos devuelto por SQLCONNECT( ). Si se especifica 0 para nConnectionHandle, SQLGETPROP( ) devolverá la configuración del entorno. - cSetting
Especifica la configuración. Vea SQLSETPROP( ) para obtener una lista de los valores que puede especificar.
Observaciones
Si se produce un error de nivel de conexión, la función devuelve – 1. Si se produce un error de nivel de entorno, devuelve – 2.
Ejemplo
En el siguiente ejemplo se utiliza SQLCONNECT( ) para mostrar el cuadro de diálogo de conexión. Elija un origen de datos y en el ejemplo se mostrarán los resultados utilizando SQLGETPROP( ) con el cSetting para DataSource.
* 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)