JET_LOGINFO-Struktur

Gilt für: Windows | Windows Server

JET_LOGINFO-Struktur

Die JET_LOGINFO-Struktur gibt strukturierte Informationen zu den Transaktionsprotokolldateien zurück, die Teil eines Sicherungsdateisatzes sein sollten. Die JET_LOGINFO-Struktur ist der minimale Satz von Informationen, die erforderlich sind, um einen Protokollbereich darzustellen, der mit JetGetLogInfoInstance2 abgerufen oder für eine harte Wiederherstellung mit JetExternalRestore2 angegeben wird.

typedef struct {
  unsigned long cbSize;
  unsigned long ulGenLow;
  unsigned long ulGenHigh;
  tchar szBaseName[JET_BASE_NAME_LENGTH + 1];
} JET_LOGINFO;

Member

cbSize

Die Größe der Struktur in Bytes.

Dieses Element ermöglicht eine zukünftige Erweiterung dieser Struktur und ermöglicht gleichzeitig abwärtskompatibel. Es sollte immer auf sizeof( JET_LOGINFO ) festgelegt werden.

ulGenLow

Die niedrigste (oder älteste) Protokolldateinummer, die wiederhergestellt wird. Die vollständige Genauigkeit eines long-Werts ohne Vorzeichen sollte beibehalten werden, aber in aktuellen Versionen der Engine ist diese Zahl eine Hexadezimalzahl im Bereich von 0x00000 bis 0xFFFFF. Dies kann sich in zukünftigen Versionen ändern.

ulGenHigh

Die höchste (oder neueste) Protokolldateinummer, die wiederhergestellt wird. Die vollständige Genauigkeit eines nicht signierten Long-Werts sollte beibehalten werden, aber in aktuellen Versionen der Engine ist diese Zahl eine Hexadezimalzahl im Bereich von 0x00000 bis 0xFFFFF. Dies kann sich in zukünftigen Versionen ändern.

szBaseName

Das Präfix, das zum Benennen der Transaktionsprotokolldateien verwendet wird.

Der wert, der in diesem Member zurückgegeben wird, ist immer gleich der Einstellung für JET_paramBaseName für die instance, die diese Informationen generiert hat.

Bemerkungen

Transaktionsprotokolldateien werden gemäß dem instance Basisnamen und der Generierungsnummer der Protokolldatei benannt. Der Name hat das Format BBBXXXXX. PROTOKOLL. BBB entspricht dem Basisnamen für die Protokolldatei und ist immer drei Zeichen lang. XXXXX entspricht der Generierungsnummer der Protokolldatei in null aufgefüllten Hexadezimalstellen und ist immer fünf Zeichen lang. LOG ist die Dateierweiterung, die transaktionsprotokolldateien von der Engine immer zugewiesen wird.

Es wird davon abgeraten, diese strukturierten Informationen zu verwenden, da sie dazu führen, dass die Anwendung über enge Kenntnisse dieses Benennungsschemas für Transaktionsprotokolldateien verfügt. Wenn sich das Benennungsschema in Zukunft ändert, funktioniert eine solche Anwendung nicht mehr ordnungsgemäß. Es ist denkbar, dass sich das Protokollformat in Zukunft ändert und 8 hexadezimale Ziffern enthält. Anwendungen sollten stattdessen die explizite Liste von Dateinamen verwenden, die von JetGetLogInfo zurückgegeben werden.

Anforderungen

Weitere Informationen

JetExternalRestore2
JetGetLogInfo
JetGetLogInfoInstance2
Systemparameter