ClfsFlushToLsn, fonction (wdm.h)
La routine ClfsFlushToLsn force à un stockage stable tous les enregistrements dont le numéro LSN 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 précédemment obtenu ce pointeur en appelant ClfsCreateMarshallingArea.
[in] plsnFlush
Pointeur vers une structure CLFS_LSN . Tous les enregistrements dont le LSN est inférieur ou égal à plsnFlush sont assurés d’être forcés à un stockage stable. Si plsnFlush est égal à CLFS_LSN_NULL, tous les enregistrements dans la zone de marshaling sont forcés à un stockage stable.
[out, optional] plsnLastFlushed
Pointeur vers une structure CLFS_LSN qui reçoit le numéro LSN du plus ancien enregistrement qui n’a pas été vidé. Il s’agit du numéro 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é à l’enregistrement suivant écrit dans le flux.
Valeur retournée
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.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Desktop (Expérience utilisateur) |
| En-tête | wdm.h (include Wdm.h) |
| Bibliothèque | Clfs.lib |
| DLL | Clfs.sys |
| IRQL | IRQL <= APC_LEVEL |