Zum Hauptinhalt springen

C16_DiagWatch

C16_DiagWatch(const vPHANDLE aInstHdl, vC16_DiagInfo* aInfo) : vERROR​

Diagnose / Recover / Schlüsselanalyse überwachen

Details

info

Zur Durchführung der Diagnose müssen alle vier Funktionen verwendet werden, um einen definierten Zustand zu behalten. Während der Diagnose können keine anderen Datenbankoperationen der Programmierschnittstelle aufgerufen werden.

Diese Funktion liefert den aktuellen Status der Diagnose.

Im Parameter (aInstHdl) wird der von C16_InitInstance() bereitgestellte Instanz-Handle, der an die Funktion C16_OpenArea() zum Öffnen der Datenbank verwendet wurde, übergeben. In (aInfo) wird ein Zeiger auf eine Informationsstruktur übergeben. Zuvor muss die Strukturkomponente InfoSize mit der Größe der Struktur initialisiert werden (sizeof(vC16_DiagInfo)).

Die Struktur ist folgendermaßen definiert:

typedef struct
{
  vINT   InfoSize;
  vLONG  Status;
  vLONG  Progress;
}
vC16_DiagInfo;
  • Komponente: Beschreibung
  • InfoSize: Größe der Struktur in Byte
  • Status: derzeitiger Status _DiagMode_None Die Diagnose wird initialisiert. _DiagMode_Read1 Strukturdiagnose (1. Lauf) _DiagMode_Recover Wiederherstellungslauf _DiagMode_Read2 Strukturdiagnose (2. Lauf) _DiagMode_Primes Primediagnose _DiagMode_KeyRef Schlüsselanalyse _DiagMode_End Diagnose abgeschlossen
  • Progress: Fortschritt des jeweiligen Laufes in Promille (0-1000)

Die Funktion muss solange aufgerufen werden, bis in der Strukturkomponente Status der Wert _DiagMode_End zurückgegeben wird. Anschließend kann das Ergebnis der Diagnose mit der Funktion C16_DiagResults() ermittelt werden. Der Diagnose-Modus wird mit der Funktion C16_DiagTerm() beendet.

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