Función SQLSetConnectInfo

  • Artículo

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

Resumen
SQLSetConnectInfo se usa para establecer el origen de datos, el identificador 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] Identificador de token.

ServerName
[Entrada] Nombre del origen 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 obtener información sobre cómo una aplicación elige un origen de datos, consulte Elección de un origen de datos o un controlador.

NameLength1
[Entrada] Longitud de *ServerName en caracteres.

UserName
[Entrada] Identificador de usuario.

NameLength2
[Entrada] Longitud de *UserName 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óstico

Igual que SQLConnect para los errores 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