Función SQLPoolConnect

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

Summary
SQLPoolConnect se utiliza para crear una nueva conexión si ninguna conexión en el pool puede reutilizarse.

Sintaxis

  
SQLRETURN  SQLPoolConnect(  
                SQLHDBC              hDbc,  
                SQLHDBC_INFO_TOKEN   hDbcInfoToken,  
                WCHAR *              wszOutConnectString,  
                SQLSMALLINT          cchConnectStringBuffer,  
                SQLSMALLINT *        cchConnectStringLen );

Argumentos

hDbc
[Entrada] La manilla de conexión.

hDbcInfoToken
[Entrada] El handle del token para la nueva solicitud de conexión de la aplicación.

wszOutConnectString
[Salida] Puntero a un buffer para la cadena de conexión completada. Tras la conexión exitosa a la fuente de datos objetivo, este búfer contiene la cadena de conexión completa. Las aplicaciones deben asignar al menos 1.024 caracteres para este búfer.

Si wszOutConnectString es NULL, cchConnectStringLen seguirá devolviendo el número total de caracteres (excluyendo el carácter de terminación nula para los datos de caracteres) disponibles para devolver en el búfer al que apunta wszOutConnectString.

cchConnectStringBuffer
[Entrada] Longitud del búfer *wszOutConnectString , en caracteres.

cchConnectStringLen
[Salida] Puntero a un búfer en el que devolver el número total de caracteres (excluyendo el carácter de terminación nula) disponibles para devolver en *wszOutConnectString. Si el número de caracteres disponibles para devolver es mayor o igual a cchConnectStringBuffer, la cadena de conexión completada en *wszOutConnectStringString se trunca a cchConnectStringBuffer menos la longitud de un carácter de terminación nula.

Devoluciones

SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_ERROR, o, SQL_INVALID_HANDLE.

Diagnósticos

Similar a SQLDriverConnect para cualquier error de validación de entrada, excepto que el Administrador de Controladores usará un HandleType de SQL_HANDLE_DBC_INFO_TOKEN y un Handle de hDbcInfoToken.

Remarks

El Driver Manager garantiza que el handle HENV principal de hDbc y hDbcInfoToken sea el mismo.

A diferencia de SQLDriverConnect, no existe un argumento DriverCompletion que invite a los usuarios a introducir información de conexión. En el escenario de pooling no se permite un diálogo de indicaciones.

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.

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.

Cuando una aplicación usa SQLConnect, wszOutConnectString será un búfer NULL (los tres últimos parámetros se establecen todos en NULL, 0, NULL). De lo contrario, el controlador debe devolver la cadena de conexión de salida, que se devolverá a la llamada a la función SQLDriverConnect de la aplicación.

Incluye sqlspi.h para el desarrollo de controladores ODBC.

Contenido relacionado

  • Last updated on