Partager via


ClfsFlushToLsn, fonction (wdm.h)

Le ClfsFlushToLsn forces de routine, pour un stockage stable, tous les enregistrements dont le nom de domaine est inférieur ou égal à un LSN spécifié.

Syntaxe

CLFSUSER_API NTSTATUS ClfsFlushToLsn(
  [in]            PVOID     pvMarshalContext,
  [in]            PCLFS_LSN plsnFlush,
  [out, optional] PCLFS_LSN plsnLastFlushed
);

Paramètres

[in] pvMarshalContext

Pointeur vers un contexte opaque associé à une zone de marshaling. L’appelant a obtenu précédemment ce pointeur en appelant ClfsCreateMarshallingArea.

[in] plsnFlush

Pointeur vers une structure CLFS_LSN. Tous les enregistrements qui ont un LSN inférieur ou égal à plsnFlush sont garantis pour être obligés d’être contraints à un stockage stable. Si plsnFlush est égal à CLFS_LSN_NULL, tous les enregistrements de la zone de marshaling sont forcés à un stockage stable.

[out, optional] plsnLastFlushed

Pointeur vers une structure CLFS_LSN qui reçoit le LSN de l’enregistrement le plus ancien qui n’a pas été vidé. Il s’agit du LSN de l’enregistrement immédiatement après le dernier enregistrement vidé.

En cas de retour réussi, plsnLastFlushed est supérieur à la valeur fournie dans plsnFlush. Toutefois, plsnLastFlushed ne pointe pas nécessairement vers un enregistrement dans le flux. Par exemple, si tous les enregistrements du flux ont été vidés, plsnLastFlushed est le LSN qui sera affecté au prochain enregistrement écrit dans le flux.

Valeur de retour

ClfsFlushToLsn retourne STATUS_SUCCESS si elle réussit ; sinon, elle retourne l’un des codes d’erreur définis dans Ntstatus.h.

Remarques

Pour obtenir une explication des concepts et de la terminologie CLFS, consultez Common Log File System.

Exigences

Exigence Valeur
plateforme cible Bureau
d’en-tête wdm.h (include Wdm.h)
bibliothèque Clfs.lib
DLL Clfs.sys
IRQL IRQL <= APC_LEVEL

Voir aussi

ClfsFlushBuffers