_DBStatus( ) (Rutina de biblioteca API)
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)