SQLDriverConnect
El controlador ODBC de SQL Native Client define los atributos de conexión que reemplazan o mejoran las palabras clave de las cadenas de conexión. Varias palabras clave de las cadenas de conexión tienes valores predeterminados que especifica el controlador ODBC de SQL Native Client.
Para obtener una lista de las palabras clave disponibles en el controlador ODBC de SQL Native Client, Using Connection String Keywords with SQL Native Client.
Para obtener más información acerca de los atributos de conexión de SQL Server y de los comportamientos predeterminados del controlador, vea SQLSetConnectAttr.
Cuando el valor del parámetro SQLDriverConnectDriverCompletion es SQL_DRIVER_PROMPT, SQL_DRIVER_COMPLETE o SQL_DRIVER_COMPLETE_REQUIRED, el controlador ODBC de SQL Native Client recupera los valores de las palabras clave del cuadro de diálogo que se muestra. Si el valor de las palabras clave se pasa en la cadena de conexión y el usuario no lo altera en el cuadro de diálogo, el controlador ODBC de SQL Native Client ODBC usa el valor de la cadena de conexión. Si el valor no se establece en la cadena de conexión y el usuario no hace ninguna asignación en el cuadro de diálogo, el controlador usa el valor predeterminado.
Se debe asignar a SQLDriverConnect un valor válido de WindowHandle cuando cualquier valor DriverCompletion requiera o pueda requerir que se muestre el cuadro de diálogo de la conexión del controlador. Si el identificador no es válido, se devuelve SQL_ERROR.
Especifique las palabras clave DRIVER o DSN. ODBC indica que el controlador usa la palabra clave situada más a la izquierda de las dos y omite la otra si se especifican ambas. Si se especifica la palabra clave DRIVER o es la situada más a la izquierda de las dos, y el valor del parámetro SQLDriverConnectDriverCompletion es SQL_DRIVER_NOPROMPT, se requieren la palabra clave SERVER y un valor apropiado.
Cuando se especifica SQL_DRIVER_NOPROMPT, las palabras clave de autenticación de usuario deben aparecer y tener valores. El controlador se asegura de que la cadena "Trusted_Connection=yes" o las dos palabras clave UID y PWD estén presentes.
Si el valor del parámetro DriverCompletion es SQL_DRIVER_NOPROMPT o SQL_DRIVER_COMPLETE_REQUIRED, y el idioma o base de datos viene de la cadena de conexión y alguno no es válido, SQLDriverConnect devuelve SQL_ERROR.
Si el valor del parámetro DriverCompletion es SQL_DRIVER_NOPROMPT o SQL_DRIVER_COMPLETE_REQUIRED, y el idioma o la base de datos deriva de las definiciones de origen de datos ODBC y alguno no es válido, SQLDriverConnect usa el idioma y la base de datos predeterminados para el identificador de usuario especificado y devuelve SQL_SUCCESS_WITH_INFO.
Si el valor del parámetro DriverCompletion es SQL_DRIVER_COMPLETE o SQL_DRIVER_PROMPT, y el idioma o la base de datos no son válidos, SQLDriverConnect vuelve a mostrar el cuadro de diálogo.
Ejemplos
La llamada siguiente ilustra la cantidad mínima de datos necesaria para SQLDriverConnect:
SQLDriverConnect(hdbc, hwnd,
(SQLTCHAR*) "DRIVER={SQL Native Client};" SQL_NTS, szOutConn,
MAX_CONN_OUT, &cbOutConn, SQL_DRIVER_COMPLETE);
Las cadenas de conexión siguientes ilustran los datos mínimos requeridos cuando el valor del parámetro DriverCompletion es SQL_DRIVER_NOPROMPT:
"DSN=Human Resources;UID=MyUserName;PWD=MyPassword"
"DSN=Human Resources;Trusted_Connection=yes"
"FILEDSN=HR_FDSN;UID=MyUserName;PWD=MyPassword"
"FILEDSN=HR_FDSN;Trusted_Connection=yes"
"DRIVER={SQL Native Client};SERVER=(local);UID=MyUserName;PWD=MyPassword"
"DRIVER={SQL Native Client};SERVER=(local);Trusted_Connection=yes"
Vea también
Conceptos
ODBC API Implementation Details
Otros recursos
SET ANSI_NULLS (Transact-SQL)
SET ANSI_PADDING (Transact-SQL)
SET ANSI_WARNINGS (Transact-SQL)
Función SQLDriverConnect