Zum Hauptinhalt springen

C16_QueryAreaInfo

C16_QueryAreaInfo(const vPHANDLE aInstHdl, vC16_ServerInfo* aInfoBlock) : vERROR​

Informationen über eine Datenbank ermitteln

Details

Der Befehl füllt eine Struktur vom Typ vC16_AreaInfo mit Informationen zu einer Datenbank. Die Struktur ist folgendermaßen definiert:

typedef struct
{
  vINT  InfoSize;
  vINT  UserID;
  vINT  UserNumber;
  vINT  AreaID;
  vLONG AreaSize;
  vLONG AreaFree;
  vINT  AreaUserCount;
  vLONG AreaStatusFlags;
  vLONG AreaRemBackupTime;
  vCHAR AreaName[128];
}
vC16_AreaInfo;
  • Komponente: Beschreibung
  • InfoSize: Größe der Struktur
  • UserID: Benutzer-ID des aktuellen Benutzers
  • UserNumber: Nummer des aktuellen Benutzers
  • AreaID: Release-Nummer der CONZEPT 16-Version
  • AreaSize: Gesamtgröße des Datenraums in KB
  • AreaFree: Größe des freien Datenraums in KB
  • AreaUserCount: Anzahl der angemeldeten Benutzer
  • AreaStatusFlags: Status der Datenbank 0x00000200 _AreaOpen Datenbank geöffnet 0x00010000 _AreaStandby Datenbank im Standby-Modus 0x00020000 _AreaReadOnly Datenbank ist schreibgeschützt (Read-Only-Modus) 0x00040000 _AreaBackup Datenbank ist im Backup-Modus 0x00080000 _AreaDiag Diagnose läuft 0x00200000 _AreaUpdate Datenbank ist im Update-Modus 0x00400000 _AreaLock Datenbank ist gesperrt 0x01000000 _AreaOptimize Optimierung läuft Es sind nur die Statusflags angegeben, die auch vom Programmierer ausgewertet werden können.
  • AreaRemBackupTime: Noch verbleibende Dauer des Sicherungsereignisses in Sekunden (vgl. C16_ServerBackup() ).
  • AreaName[128]: Dateiname der Datenbank

Im Parameter (aInstHdl) wird der von C16_InitInstance() bereitgestellte Instanz-Handle, der in der Funktion C16_OpenArea() zum Öffnen der Datenbank verwendet wurde, übergeben. Die Informationen werden in die Informationsstruktur übertragen, deren Adresse in (aInfoBlock) übergeben wurde. Vor dem Aufruf der Funktion muss die Strukturkomponente InfoSize mit der Größe der Struktur initialisiert werden (sizeof(vC16_AreaInfo)).

Der Rückgabewert vom Typ vERROR beinhaltet entweder 0 (kein Fehler) oder einen negativen Fehlerwert (siehe Fehlerwerte ).