ILog::Force-Methode (txlogpub.h)
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 |