Función SQLPoolConnect

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

Resumen
SQLPoolConnect se usa para crear una nueva conexión si no se puede reutilizar ninguna conexión en el grupo.

Sintaxis

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

Argumentos

hDbc
[Entrada] Identificador de conexión.

hDbcInfoToken
[Entrada] Identificador de token para la nueva solicitud de conexión de aplicación.

wszOutConnectString
[Salida] Puntero a un búfer para la cadena de conexión completada. Tras una conexión correcta al origen de datos de destino, este búfer contiene la cadena de conexión completada. Las aplicaciones deben asignar al menos 1024 caracteres para este búfer.

Si wszOutConnectString es NULL, cchConnectStringLen seguirá devolviendo el número total de caracteres (excepto el carácter de terminación NULL para los datos de caracteres) disponible 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 se devuelve el número total de caracteres (excepto el carácter de terminación NULL) disponible para devolver en *wszOutConnectString. Si el número de caracteres disponibles para devolver es mayor o igual que cchConnectStringBuffer, la cadena de conexión completada en *wszOutConnectString se trunca a cchConnectStringBuffer menos la longitud de un carácter de terminación null.

Devoluciones

SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_ERROR o SQL_INVALID_HANDLE.

Diagnóstico

De forma similar a SQLDriverConnect para cualquier error de validación de entrada, salvo que el Administrador de controladores usará un HandleType de SQL_HANDLE_DBC_INFO_TOKEN y un identificador de hDbcInfoToken.

Comentarios

El Administrador de controladores garantiza que el identificador HENV primario de hDbc y hDbcInfoToken son los mismos.

A diferencia de SQLDriverConnect, no hay ningún argumento DriverCompletion para pedir a los usuarios que escriban información de conexión. No se permite un cuadro de diálogo de solicitud en el escenario de agrupación.

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.

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.

Cuando una aplicación usa SQLConnect, wszOutConnectString será un búfer NULL (los tres últimos parámetros se establecerán 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.

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