Función SQLSetDriverConnectInfo

Conformidad
Versión introducida: Cumplimiento de estándares ODBC 3.81: ODBC

Resumen
SQLSetDriverConnectInfo se usa para establecer la cadena de conexión en el token de información de conexión para la llamada SQLDriverConnect de una aplicación.

Sintaxis

  
SQLRETURN SQLSetDriverConnectInfo(  
                SQLHDBC_INFO_TOKEN   hDbcInfoToken,  
                WCHAR *              InConnectionString,  
                SQLSMALLINT          StringLength1 );  

Argumentos

TokenHandle
[Entrada] Identificador de token.

InConnectionString
[Entrada] Una cadena de conexión completa (vea la sintaxis en "Comments" en SQLDriverConnect), una cadena de conexión parcial o una cadena vacía.

StringLength1
[Entrada] Longitud de *InConnectionString, en caracteres si la cadena es Unicode o bytes si string es ANSI o DBCS.

Devoluciones

SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_ERROR o SQL_INVALID_HANDLE.

Diagnóstico

Igual que SQLDriverConnect relacionado con cualquier error de validación de entrada, excepto que el Administrador de controladores usará un HandleType de SQL_HANDLE_DBC_INFO_TOKEN y un identificador de hDbcInfoToken.

Comentarios

Cada vez que un controlador devuelve SQL_ERROR o SQL_INVALID_HANDLE, el Administrador de controladores devuelve el error a la aplicación (en SQLConnect o SQLDriverConnect).

Cada vez que un controlador devuelve SQL_SUCCESS_WITH_INFO, el Administrador de controladores obtendrá la información de diagnóstico de hDbcInfoToken y devolverá SQL_SUCCESS_WITH_INFO a la aplicación en SQLConnect y SQLDriverConnect.

Las aplicaciones no deben llamar directamente a esta función. Un controlador ODBC que admita la agrupación de conexiones compatibles con controladores debe implementar esta función.

Incluya sqlspi.h para el desarrollo de controladores ODBC.

Consulte también

Desarrollar un controlador ODBC
Agrupación de conexiones dependientes del controlador
Desarrollar el conocimiento de la agrupación de conexiones en un controlador ODBC