DBINFO()
 Devuelve y, opcionalmente modifica, la información acerca de un fichero de
 base de datos abierto en un área de trabajo.
------------------------------------------------------------------------------
 Sintaxis

     DBINFO(<nTipoInfo>, [<expNuevosValores>])
        --> uValoresActuales

 Argumentos

     <nTipoInfo> determina el tipo de información mediante las
     constantes de la tabla siguiente. Recuerde, no obstante, que algunas de
     estas constantes no están disponibles en todos los RDD. El fichero con
     la declaración de las constantes, Dbinfo.ch, se debe incluir (#include)
      en la aplicación.

     Constantes del tipo de información acerca del fichero
     ------------------------------------------------------------------------
     Constante                Descripción
     ------------------------------------------------------------------------
     DBI_ALIAS                Alias del área de trabajo como una cadena
                              de caracteres.
     DBI_BLOB_DIRECT_LEN      Devuelve el tamaño de un elemento de datos
                              en un fichero BLOB. <expNuevosValores> debe
                              ser un puntero válido a datos del tipo BLOB,
                              obtenido mediante DBFIELDINFO(DBS_BLOB_POINTER,
                              <nPosCampo>), BLOBDIRECTPUT() o
                              BLOBDIRECTIMPORT().
     DBI_BLOB_DIRECT_TYPE     Devuelve el tipo de datos de un elemento
                              de datos en un fichero BLOB. <expNuevosValores>
                              debe ser un puntero válido a datos del tipo
                              BLOB, obtenido mediante DBFIELDINFO
                              (DBS_BLOB_POINTER, <nPosCampo>),
                              BLOBDIRECTPUT() o BLOBDIRECTIMPORT().
     DBI_BLOB_INTEGRITY       Comprueba la integridad de las tablas
                              internas de un fichero BLOB. Si la
                              comprobación de integridad es correcta,
                              devuelve (.T.); en otro caso devuelve (.F.).
                              Si la integridad de las tablas falla, es
                              posible repararla utilizando la función
                              DBINFO(DBI_BLOB_RECOVER). La comprobación de
                              la integridad de un fichero BLOB es una
                              operación intensiva y sólo se debe llevar
                              a cabo cuando existan razones fundadas de
                              que la integridad no es correcta.
     DBI_BLOB_OFFSET          Devuelve el desplazamiento de un elemento
                              de datos dentro de un fichero BLOB.
                              <expNuevosValores> debe ser un puntero válido
                              a datos del tipo BLOB, obtenido mediante
                              DBFIELDINFO(DBS_BLOB_POINTER, <nPosCampo>),
                              BLOBDIRECTPUT() o BLOBDIRECTIMPORT().
     DBI_BLOB_RECOVER         Repara las tablas internas de un fichero BLOB.
                              Sólo se debe utilizar este valor si
                              DBINFO(DBI_BLOB_INTEGRITY) devuelve falso
                              (.F.). Recuerde que esta función no recupera
                              los datos a los que haya afectado la pérdida de
                              integridad de las tablas.
     DBI_BOF                  Valor lógico que indica si se ha encontrado o
                              no el inicio del fichero (consulte BOF()).
     DBI_CANPUTREC            Valor lógico que indica si el área de trabajo
                              admite inserción de registros.
     DBI_CHILDCOUNT           Número de relaciones establecidas en el área
                              de trabajo.
     DBI_DB_VERSION           Cadena de caracteres que contiene información
                              sobre la versión del RDD principal. Si el
                              parámetro opcional <expNuevosValores> tiene
                              el valor uno (1), se amplía la información con
                              detalles adicionales.
     DBI_DBFILTER             Expresión de filtro declarada como una cadena
                              de caracteres (consulte DBFILTER()).
     DBI_EOF                  Valor lógico que indica si se ha encontrado
                              o no el final del fichero (consulte EOF()).
     DBI_FCOUNT               Número de campos (consulte FCOUNT()).
     DBI_FILEHANDLE           Número entero que representa el manejador
                              DOS del fichero de base de datos.
     DBI_FOUND                Valor lógico que indica el éxito o fallo
                              de la última operación de búsqueda en el área
                              de trabajo (consulte FOUND()).
     DBI_FULLPATH             Devuelve el nombre completo de la vía de
                              acceso del fichero de base de datos abierto.
     DBI_GETDELIMITER         Delimitador por defecto.
     DBI_GETHEADERSIZE        Tamaño de la cabecera del fichero (consulte
                              HEADER()).
     DBI_GETLOCKARRAY         Matriz de registros bloqueados.
     DBI_GETRECSIZE           Tamaño de los registros del fichero (consulte
                              RECSIZE()).
     DBI_ISDBF                Valor lógico que indica si el RDD admite el
                              formato de fichero .dbf.
     DBI_ISFLOCK              Estado del bloqueo del fichero.
     DBI_LASTUPDATE           Ultima fecha en la que se realizó una
                              actualización del fichero (consulte LUPDATE()).
     DBI_LOCKCOUNT            Número de registros bloqueados
     DBI_LOCKOFFSET           Valor numérico que indica el desplazamiento
                              actual del bloqueo.
     DBI_MEMOBLOCKSIZE        Tamaño de bloque del fichero memo asociado a
                              la base de datos.
     DBI_MEMOEXT              Extensión por defecto del fichero memo asociado
                              a la base de datos.
     DBI_MEMOHANDLE           Número entero que representa el manejador
                              del fichero del DOS para el fichero memo
                              asociado a la base de datos.
     DBI_RDD_VERSION          Cadena de caracteres que contiene información
                              sobre la versión del RDD para esta base de
                              datos. Si el parámetro opcional
                              <expNuevosValores> tiene el valor uno (1),
                              se amplía la información con detalles
                              adicionales.
     DBI_SETDELIMITER         Delimitador por defecto.
     DBI_SHARED               Valor del indicador de modo compartido.
     DBI_TABLEEXT             Extensión del fichero de base de datos.
     DBI_VALIDBUFFER          Valor lógico que indica si la memoria
                              intermedia actual es válida.
     -----------------------------------------------------------------------

     ¡Importante! DBI_USER es una constante que devuelve el valor mínimo
     que pueden utilizar los desarrolladores de RDD de terceros para definir
     nuevos parámetros de <nTipoInfo>. Los valores por debajo de DBI_USER
     están reservados para los desarrolladores de Computer Associates.

     <expNuevosValores> es utilizado por los RDD que, además de
     consultar, también permiten modificar la información acerca de un
     fichero. Ninguno de los RDD que se suministran con CA-Clipper admite
     este argumento. Puede omitirse o establecerse en NIL.

 Devuelve

     Si <expNuevosValores> no se especifica, DBINFO() devuelve los
     parámetros actuales del fichero. Si <expNuevosValores> se especifica,
     devuelve los anteriores parámetros.

 Descripción

     DBINFO() lee información acerca de un fichero de base de datos. Por
     defecto, esta función opera en el área de trabajo seleccionada. Si
     desea utilizarla en otra área de trabajo, debe especificarla con una
     expresión de alias.

 Ejemplos

      Los ejemplos siguientes recuperan información del área de
        trabajo:

        #include Dbinfo.ch
        ?  DBINFO(DBI_GETHEADERSIZE)            // Similar a HEADER()
        ?  DBINFO(DBI_LASTUPDATE)               // Similar a LUPDATE()
        ?  DBINFO(DBI_GETRECSIZE)               // Similar a RECSIZE()
        ?  DBINFO(DBI_FILEHANDLE)               // Manejador DOS del fichero

 Ficheros   La biblioteca asociada es CLIPPER.LIB,
            el fichero de cabecera es Dbinfo.ch.