SQLSETPROP( ) (Función)

Especifica la configuración de una conexión activa.

SQLSETPROP(nConnectionHandle, cSetting [, eExpression])

Valores devueltos

Numeric

Parámetros

• nConnectionHandle
  Especifica el identificador de conexión al origen de datos devuelto por SQLCONNECT( ).

• cSetting
  Especifica la configuración. La tabla siguiente muestra los valores de cSetting.

  Valor	Descripción
  Asynchronous	Especifica si los conjuntos de resultados se devuelven en modo síncrono (falso (.F.), el valor predeterminado) o en modo asíncrono (verdadero (.T.)). Lectura y escritura.
  BatchMode	Especifica si SQLEXEC( ) devuelve los conjuntos de resultados de una vez (verdadero (.T.), el valor predeterminado) o individualmente con SQLMORERESULTS( ) (falso (.F.)). Lectura y escritura.
  ConnectBusy	Contiene verdadero (.T.) si una conexión compartida está ocupada; de lo contrario, contiene falso (.F.). Sólo lectura.
  ConnectString	La cadena de conexión de inicio de sesión. Sólo lectura.
  ConnectTimeOut	Especifica el tiempo de espera (en segundos) antes de devolver un error de tiempo de espera de conexión. Si especifica 0 (el valor predeterminado), la espera es indefinida y no se devuelve un error de tiempo de espera. ConnectTimeOut puede estar entre 0 y 600. El valor predeterminado es 15. Lectura y escritura.
  DataSource	El nombre del origen de datos definido en el archivo ODBC.INI. Lectura y escritura.
  DispLogin	Contiene un valor Numeric que determina cuándo se muestra el cuadro de diálogo de inicio de sesión ODBC. DispLogin puede adoptar los valores siguientes: 1 o DB_PROMPTCOMPLETE (de FOXPRO.H). El valor predeterminado es 1. 2 o DB_PROMPTALWAYS (de FOXPRO.H). 3 o DB_PROMPTNEVER (de FOXPRO.H). Si se especifica 1 o DB_PROMPTCOMPLETE, Visual FoxPro sólo mostrará el cuadro de diálogo de inicio de sesión ODBC si falta información necesaria. Si se especifica 2 o DB_PROMPTALWAYS, siempre se muestra el cuadro de diálogo de inicio de sesión de ODBC, que permite cambiar las opciones antes de conectar. Si se especifica 3 o DB_PROMPTNEVER, no se mostrará el cuadro de diálogo de inicio de sesión ODBC y Visual FoxPro generará un error si no está disponible la información de inicio de sesión. Lectura y escritura.
  DispWarnings	Especifica si se muestran (verdadero (.T.)) o no se muestran (falso (.F.)) mensajes de error. El valor predeterminado es que los mensajes de error no se muestran. Lectura y escritura.
  IdleTimeout	El intervalo de espera de inactividad en segundos. Las conexiones activas se desactivan después del intervalo de tiempo especificado. El valor predeterminado es 0 (espera indefinidamente). Lectura y escritura.
  ODBChdbc	El controlador interno de conexión ODBC que pueden emplear los archivos externos de biblioteca (archivos FLL) para llamar a ODBC. Sólo lectura.
  ODBChstmt	El controlador interno de instrucción ODBC que pueden emplear los archivos externos de biblioteca (archivos FLL) para llamar a ODBC. Sólo lectura.
  PacketSize	El tamaño del paquete de red usado por la conexión. Ajustar este valor puede mejorar el rendimiento. El valor predeterminado es 4096 bytes (4K). Lectura y escritura
  Password	La contraseña de conexión. Sólo lectura.
  QueryTimeOut	Especifica el tiempo de espera (en segundos) antes de devolver un error general de tiempo de espera. Si especifica 0 (predeterminado), la espera es indefinida y no se devuelve un error de tiempo de espera. QueryTimeOut puede estar entre 0 y 600. Lectura y escritura.
  Transactions	Contiene un valor numérico que determina cómo administra la conexión las transacciones en la tabla remota. Las transacciones pueden adoptar los valores siguientes: 1 o DB_TRANSAUTO (de FOXPRO.H). El valor predeterminado es 1. El proceso de transacciones para la tabla remota se administra automáticamente. 2 o DB_TRANSMANUAL (de FOXPRO.H). El proceso de transacciones se controla automáticamente mediante SQLCOMMIT( ) y SQLROLLBACK( ). Lectura y escritura.
  UserId	La identificación del usuario. Sólo lectura.
  WaitTime	La cantidad de tiempo, en milisegundos, que transcurre antes de que Visual FoxPro compruebe si la instrucción SQL ha terminado de ejecutarse. El valor predeterminado es 100 milisegundos. Lectura y escritura.

• eExpression
  Especifica el valor para el valor designado con cSetting. Si se omite eExpression, se restaurará el valor predeterminado.

Observaciones

SQLSETPROP( ) devuelve 1 si es correcta; de lo contrario, devolverá – 1 si se produce un error de nivel de conexión o – 2 si se produce un error de nivel de entorno.

Utilice SQLSETPROP( ) para especificar el valor en el nivel de conexión. Para especificar valores predeterminados de Visual FoxPro en el nivel de entorno, incluya 0 como identificador de conexión.

La opción ConnectTimeout sólo puede establecerse en el nivel de Visual FoxPro y no tiene equivalente en el nivel de conexión. Puede establecer las opciones restantes en el nivel de conexión o de Visual FoxPro. Cada opción establecida en el nivel de Visual FoxPro sirve como valor predeterminado para conexiones posteriores.

Utilice SQLGETPROP( ) para devolver el valor actual para una configuración especificada.

Nota   El cuadro de diálogo de inicio de sesión ODBC debe estar desactivado para admitir el paso de SQL con Microsoft Transaction Server. Utilice SQLSETPROP(cConnectionHandle, 'DispLogin', 3) para desactivar el cuadro de diálogo de inicio de sesión ODBC. El cuadro de diálogo de inicio de sesión ODBC también se puede desactivar en el Diseñador de conexiones.

Ejemplo

SQLSETPROP( ) sirve para establecer el tamaño del paquete para la conexión actual.

* Clear environment
CLOSE ALL
CLEAR ALL
CLEAR

* Display the Select Connection or Datasource dialog box
* to choose a connection
nHandle=SQLCONNECT()

* Test connection, report results
IF nHandle > 0
   * Set PacketSize
   nSet=SQLSETPROP(nHandle, "PacketSize", 2048 )
   * Test setting and display results
   IF nSet > 0
      =MESSAGEBOX("PacketSize was set to 2048",0,"Connection Results")
   ELSE
      =MESSAGEBOX("Error setting PacketSize",0,"Connection Results")
   ENDIF
ELSE
   =MESSAGEBOX("No Connection",0,"Connection Results")
ENDIF
=SQLDISCONNECT(nHandle)

Vea también

AERROR( ) | SQLGETPROP( ) | Diseñador de conexiones