_DBStatus( ) (Rutina de biblioteca API)

  • Artículo

Devuelve indicadores de estado del área de trabajo especificada.

int _DBStatus(int workarea)
int workarea;               /* Work area. */

Observaciones

Si no hay una tabla abierta en el área de trabajo especificada, _DBStatus( ) devuelve un número entero negativo cuyo valor absoluto corresponde a un número de error de Visual FoxPro. La siguiente tabla muestra los indicadores de estado que devuelve:

Indicador Valor
DB_BOF Se establece bajo las mismas condiciones que la función BOF( ) de Visual FoxPro.
DB_EOF Se establece bajo las mismas condiciones que la función EOF( ) de Visual FoxPro.
DB_RLOCKED Se establece cuando el registro actual está bloqueado, la tabla está bloqueada o está abierta de forma exclusiva.
DB_FLOCKED Se establece cuando la tabla está bloqueada o está abierta de forma exclusiva.
DB_EXCLUSIVE Se establece cuando la tabla está abierta de forma exclusiva.
DB_READONLY Se establece cuando la tabla se abre sin acceso para escritura.

Para obtener más información acerca de cómo crear una biblioteca API e integrarla con Visual FoxPro, vea Acceso a la API de Visual FoxPro.

Ejemplo

El siguiente ejemplo muestra el estado de la tabla abierta en el área de trabajo actual. Comprueba cada bit en el valor devuelto por _DBStatus( ) y muestra un mensaje apropiado en pantalla.

Código Visual FoxPro

SET LIBRARY TO DBSTATUS
= DBSTATUS()  && displays status of DBF in current work area

Código C

#include <pro_ext.h>

FAR Example(ParamBlk FAR *parm)
{
   int dbstatus = _DBStatus(-1);
   _PutStr("\nStatus of DBF in current work area:");
   if (dbstatus & DB_BOF)
      _PutStr("\nBOF()");
   if (dbstatus & DB_EOF)
      _PutStr("\nEOF()");
   if (dbstatus & DB_RLOCKED)
      _PutStr("\nCurrent record is RLOCKed");
   if (dbstatus & DB_FLOCKED)
      _PutStr("\nDatabase is FLOCKed");
   if (dbstatus & DB_EXCLUSIVE)
      _PutStr("\nDatabase is open EXCLUSIVEly");
   if (dbstatus & DB_READONLY)
      _PutStr("\nDatabase is READONLY");
}

FoxInfo myFoxInfo[] = {
   {"DBSTATUS", (FPFI) Example, 0, ""},
};
FoxTable _FoxTable = {
   (FoxTable FAR *) 0, sizeof(myFoxInfo)/sizeof(FoxInfo), myFoxInfo
};

Vea también

_DBLock( ) (Rutina de biblioteca API) | _DBUnlock( ) (Rutina de biblioteca API) | Acceso a la API de Visual FoxPro | BOF( ) (Función) | EOF( ) (Función) | ISRLOCKED( ) (Función) | ISFLOCKED( ) (Función) | ISEXCLUSIVE( ) (Función) | ISREADONLY( ) (Función)