CDatabase::Open

virtual BOOL Abierto ( LPCTSTR lpszDSN, BOOL bExclusive = FALSE, BOOL bReadOnly = FALSE, LPCTSTR lpszConnect = "ODBC", BOOL bUseCursorLib = TRUE );
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

lpszDSN

Especifica un nombre de origen de datos — un nombre registrado con ODBC a través del programa Administrador de ODBC. Si se especifica un valor DSN en lpszConnect (en el formulario "DSN = lt; origen de datos >"), no debe ser especificado de nuevo en lpszDSN. En este caso, lpszDSN debe ser nula. De lo contrario, se puede pasar NULL si desea presentar al usuario un cuadro de diálogo de origen de datos en la que el usuario puede seleccionar un origen de datos. Para obtener más información, vea la sección Comentarios.

bExclusive

No se admite en esta versión de la biblioteca de clases. Actualmente, una aserción falla si este parámetro es TRUE. El origen de datos se abre siempre como compartidos (no exclusiva).

bReadOnly

TRUE si desea que la conexión sea de sólo lectura y prohibir las actualizaciones al origen de datos. Todos los conjuntos de registros dependientes heredan este atributo. El valor predeterminado es FALSE.

lpszConnect

Especifica una cadena de conexión. La cadena de conexión concatena información, posiblemente incluyendo un nombre de origen de datos, un ID de usuario válido en el origen de datos, una cadena de autenticación de usuario (contraseña, si el origen de datos requiere uno) y otra información. La cadena de conexión completa debe ser precedida de la cadena "ODBC;" (mayúsculas o minúsculas). El "ODBC" cadena se utiliza para indicar que la conexión a un origen de datos ODBC; Esto es para compatibilidad con versiones posteriores cuando las versiones futuras de la biblioteca de clases podrían apoyar a orígenes de datos ODBC no.

bUseCursorLib

TRUE si desea que el Cursor ODBC biblioteca DLL para ser cargados. La biblioteca de cursores máscaras cierta funcionalidad del controlador ODBC subyacente, prevenir eficazmente el uso de conjuntos de registros dinámicos (si el controlador admite). Los cursores sólo admitidos si se carga la biblioteca de cursores son instantáneas estáticas y cursores sólo hacia delante. El valor predeterminado es TRUE. Si va a crear un objeto recordset directamente desde CRecordset sin derivadas de ella, no debe cargar la biblioteca de cursores.

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.

&Notanbsp;  Llamar a la función miembro OpenEx es el modo preferido para conectarse a un origen de datos e inicializar el objeto de base de datos.

Si los parámetros en la llamada Open no contienen 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. Cuando usted llama abierta, su cadena de conexión, lpszConnect, es privada almacenada en el objeto CDatabase y está disponible mediante una llamada a la función de miembro de GetConnect.

Si lo desea, puede abrir su propio cuadro de diálogo antes de llamar a Abrir 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 Abrir. O puede que desee guardar la cadena de conexión que pasa por lo que se puede reutilizar la próxima vez que su aplicación llama abierta en 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, abierto produce un CDBException.

Ejemplo

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

/ / Conectar el objeto a un
/ / origen de datos (sin contraseña)
/ / cuadro de diálogo de la conexión ODBC
/ / siempre permanecerá oculto
m_dbCust.Open (_T ("MIORIGE&NDEDATOS"), FALSE,
 nbsp;             FALSO, _T ("ODBC;UID = JOES "),

// ...O consulta el usuario para todos
/ / información de conexión
m_dbCust.Open (NULL)

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

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

Index