CDatabase::OpenEx

virtual BOOL OpenEx (LPCTSTR lpszConnectString, DWORD dwOptions = 0 );
tirar (CDBException, CMemoryException);

Valor devuelto

Distinto de cero si la conexión se realiza correctamente; en caso contrario 0 si el usuario decide cancelar cuando presentó un cuadro de diálogo pidiendo más información de conexión. En los demás casos, el marco produce una excepción.

Parámetros

lpszConnectString

Especifica la cadena de conexión de un ODBC. Esto incluye el nombre del origen de datos, así como otra información opcional, como un ID de usuario y una contraseña. Por ejemplo, "DSN = SQLServer_Source;UID = SA;PWD = abc123 "es una cadena de conexión posible. Tenga en cuenta que si se pasa NULL para lpszConnectString, un cuadro de diálogo de origen de datos le pedirá al usuario que seleccione un origen de datos.

dwOptions

Una máscara de bits que especifica una combinación de los siguientes valores. El valor predeterminado es 0, lo que significa que la base de datos se abrirá como comparte con acceso de escritura, el Cursor ODBC biblioteca DLL no se cargará y se mostrará el cuadro de diálogo de conexión de ODBC sólo si no hay suficiente información para realizar la conexión.

Observaciones

Llame a esta función miembro para inicializar un objeto CDatabase recién construido. El objeto de base de datos debe inicializarse antes de que se puede utilizar para construir un objeto recordset.

Si el parámetro lpszConnectString en la llamada OpenEx no contiene suficiente información para realizar la conexión, el controlador ODBC abre un cuadro de diálogo para obtener la información necesaria del usuario, siempre que no hayan establecido CDatabase::noOdbcDialog o CDatabase::forceOdbcDialog en el parámetro dwOptions . Cuando se llama OpenEx, la cadena de conexión, lpszConnectString, es privada almacenada en el objeto CDatabase y está disponible mediante una llamada a la función miembro GetConnect.

Si lo desea, puede abrir su propio cuadro de diálogo antes de llamar a OpenEx para obtener información del usuario, como una contraseña y luego añadir esa información a la cadena de conexión que pasa a OpenEx. O puede que desee guardar la cadena de conexión que pasa por lo que se puede reutilizar la próxima vez que la aplicación llama OpenEx sobre un objeto CDatabase.

También puede utilizar la cadena de conexión para varios niveles de autorización de inicio de sesión (cada uno para un objeto CDatabase distinto) o transmitir otra información específica de la fuente de datos. Para obtener más información acerca de las cadenas de conexión, consulte el capítulo 5 en la referencia del programador del SDK de ODBC.

Es posible que un intento de conexión a la hora de salida si, por ejemplo, el host DBMS está disponible. Si falla el intento de conexión, OpenEx produce un CDBException.

Ejemplo

/ / Incrustar un objeto CDatabase
/ / en la clase de documento
CDatabase m_dbCust;

/ / Conectar el objeto a una / / donde de origen de datos de sólo lectura
/ / cuadro de diálogo de la conexión ODBC
/ / siempre permanecerá oculto
m_dbCust.OpenEx (_T ("DS&N = MIORIGENDEDATOS;UID = JOES "),
 nbsp;               CDatabase::openReadOnly |
                 CDatabase::noOdbcDialog)

Visió&n General de CDatabase |nbsp; Miembros de clase | Diagrama de jerarquía

Vea tambié&nnbsp;CDatabase::Open, CDatabase::CDatabase, CDatabase::Close, CDBException, ser

Index