ILog::Force-Methode (txlogpub.h)

  • Artikel

Erzwingt den Inhalt des Protokolls auf dem Datenträger, zumindest bis zur angegebenen LSN.

Syntax

HRESULT Force(
  [in] LSN lsnMinToForce
);

Parameter

[in] lsnMinToForce

Mindestens alle Datensätze, die noch nicht auf den Datenträger mit einer LSN kleiner oder gleich lsnMinToForce geschrieben wurden, müssen jetzt auf den Datenträger geschrieben werden. Eine Implementierung kann sich jedoch dafür entscheiden, mehr Datensätze zu schreiben, als unbedingt erforderlich ist. Beispielsweise kann eine Implementierung alle Datensätze auf dem Datenträger erzwingen, unabhängig vom Wert von lsnMinToForce. Die Übergabe von 0 als lsnMinToForce gibt an, dass das gesamte Protokoll auf den Datenträger erzwungen werden soll.

Rückgabewert

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Das Protokoll kann auch auf den Datenträger gezwungen werden, nachdem einzelne Datensätze angefügt wurden. Siehe ILog::AppendRecord.

Hinweise für Anrufer

Ein Fehlerrückgabewert gibt an, dass alle Datensätze, die seit dem letzten erfolgreichen Erzwungenen an das Protokoll angefügt wurden, nicht garantiert auf dem Datenträger sind. Die ILog-Schnittstelle stellt keine Methode bereit, um zu bestimmen, welche Datensätze erfolgreich auf den Datenträger geschrieben wurden. Wenn Sie wissen müssen, welche Datensätze erfolgreich auf den Datenträger geschrieben wurden, müssen Sie das Protokoll für jeden Datensatz erzwingen. Siehe ILog::AppendRecord.

Hinweise für Implementierer

Es wird empfohlen, Dateipuffer zu leeren (z. B. mithilfe der FlushFileBuffers-Funktion ), bevor Sie von dieser Methode zurückgeben.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile txlogpub.h

Weitere Informationen

FlushFileBuffers

Ilog