BLOBROOTGET()
 Recupera datos almacenados en el  rea raíz de un fichero BLOB
------------------------------------------------------------------------------
 Sintaxis

     BLOBROOTGET() --> uBLOB

 Devuelve

     BLOBROOTGET() devuelve los datos recuperados del  rea raíz del  fichero
     BLOB. El tipo de datos del valor devuelto depende de los datos
     almacenados. Utilice VALTYPE() o USUALTYPE() para conocer el tipo de
     datos. Observe que BLOBROOTGET() devuelve NIL si no se ha utilizado
     antes BLOBROOTPUT() para escribir el  rea raíz.

 Descripción

     BLOBROOTGET() permite la recuperación de datos almacenados en el  rea
     raíz de un fichero BLOB en un  rea de trabajo. 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.

     Nota: Debido a que los datos del  rea raíz no hacen referencia a
     ningún registro de la base de datos, DBRLOCK() no protege los datos
     almacenados en el  rea raíz. Por consiguiente, si el fichero de la base
     de datos se abrió en modo compartido, se debe utilizar BLOBROOTLOCK()
     antes de llamar a BLOBROOTGET().

 Ejemplos

      Este ejemplo utiliza BLOBROOTGET() para leer los par metros
        del sistema de un fichero BLOB y guardarlos en una matriz. A
        continuación, demuestra cómo permitir al usuario modificar los
        par metros y almacenarlos en el fichero BLOB:

        FUNCTION ACTUALIZARPARAMETROS()
           LOCAL aParams

           USE Cliente NEW SHARED VIA "DBFCDX"

           IF BLOBROOTLOCK()
              // Se obtienen los par metros actuales
              aParams := BLOBROOTGET()

              IF Empty(aParams)
                  // Se rellena aParams con datos por defecto
                  aParams := GETDEFAULTSETTINGS()
              ENDIF

              // Esta función permitiría al usuario modificar
              // los par metros
              IF ModificarParams(aParams)
                  // Finalmente, se almacenan los par metros
                  BLOBROOTPUT(aParams)
              ENDIF
              BLOBROOTUNLOCK()
           ELSE
              aParams := {}
              Alert("Es posible que se puede bloquear el  rea raíz")
           ENDIF

           CLOSE

           RETURN aParams

 To download this example - click here.

See Also: BLOBROOTLOCK() BLOBROOTPUT() DBRLOCK() DBUSEAREA()