Función SQLSetConnectInfo

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

Summary
SQLSetConnectInfo se utiliza para establecer la fuente de datos, el ID de usuario y la contraseña en el token de información de conexión para la llamada SQLConnect de una aplicación.

Sintaxis

  
SQLRETURN  SQLSetConnectInfo(  
                SQLHDBC_INFO_TOKEN   TokenHandle,  
                WCHAR *              ServerName,  
                SQLSMALLINT          NameLength1,  
                WCHAR *              UserName,  
                SQLSMALLINT          NameLength2,  
                WCHAR *              Authentication,  
                SQLSMALLINT          NameLength3 );

Argumentos

TokenHandle
[Entrada] Usuario de token.

ServerName
[Entrada] Nombre de la fuente de datos. Los datos pueden encontrarse en el mismo equipo que el programa o en otro equipo en algún lugar de una red. Para información sobre cómo una aplicación elige una fuente de datos, consulte Elección de una fuente de datos o controlador.

NameLength1
[Entrada] Longitud de *Nombre del Servidor en caracteres.

UserName
[Entrada] Identificador de usuario.

NameLength2
[Entrada] Longitud de *Nombre de usuario en caracteres.

Autenticación
[Entrada] Cadena de autenticación (normalmente la contraseña).

NameLength3
[Entrada] Longitud de *Autenticación en caracteres.

Devoluciones

SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_ERROR o SQL_INVALID_HANDLE.

Diagnósticos

Igual que SQLConnect para errores de validación de entrada, excepto que el Driver Manager 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