Función SQLSetDriverConnectInfo

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

Summary
SQLSetDriverConnectInfo se utiliza 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] Usuario de token.

InConnectionString
[Entrada] Una cadena de conexión completa (véase la sintaxis en "Comentarios" 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 la cadena es ANSI o DBCS.

Devoluciones

SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_ERROR o SQL_INVALID_HANDLE.

Diagnósticos

Igual que SQLDriverConnect en relación con cualquier error de validación de entrada, excepto que el Gestor de Controladores usará un HandleType de SQL_HANDLE_DBC_INFO_TOKEN y un Handle de hDbcInfoToken.

Remarks

Siempre 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 devuelva 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 soporte pooling de conexiones consciente del controlador debe implementar esta función.

Incluye sqlspi.h para el desarrollo de controladores ODBC.

Contenido relacionado

  • Last updated on