Méthode ILog::Force (txlogpub.h)
Force le contenu du journal sur le disque, au moins vers le haut via le LSN spécifié.
Syntaxe
HRESULT Force(
[in] LSN lsnMinToForce
);
Paramètres
[in] lsnMinToForce
À tout le moins, tous les enregistrements qui n’ont pas encore été écrits sur le disque avec un LSN inférieur ou égal à lsnMinToForce doivent être écrits sur disque maintenant. Toutefois, une implémentation peut choisir d’écrire plus d’enregistrements que ce qui est strictement requis. Par exemple, une implémentation est autorisée à forcer tous les enregistrements sur le disque, quelle que soit la valeur de lsnMinToForce. La transmission de 0 en tant que lsnMinToForce indique que l’intégralité du journal doit être forcée sur le disque.
Valeur retournée
Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.
Remarques
Le journal peut également être forcé sur le disque après l’ajout d’enregistrements individuels. Consultez ILog::AppendRecord.
Notes aux appelants
Une valeur de retour d’échec indique que tous les enregistrements ajoutés au journal depuis la dernière fois qu’il a été forcé avec succès ne sont pas garantis sur le disque. L’interface ILog ne fournit pas de méthode permettant de déterminer quels enregistrements ont été correctement écrits sur le disque. Si vous avez besoin de savoir quels enregistrements ont été correctement écrits sur le disque, vous devez forcer le journal pour chaque enregistrement. Consultez ILog::AppendRecord.Notes aux implémenteurs
Il est recommandé de vider les mémoires tampons de fichiers (par exemple, à l’aide de la fonction FlushFileBuffers ) avant de retourner à partir de cette méthode.Configuration requise
| Client minimal pris en charge | Windows XP [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2003 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | txlogpub.h |