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 |