ClfsFlushToLsn, fonction (wdm.h)

La routine ClfsFlushToLsn force, dans le stockage stable, tous les enregistrements qui ont un LSN 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 qui ont un LSN inférieur ou égal à plsnFlush sont garantis pour être forcés à 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 du plus ancien enregistrement qui n’a pas été vidé. Il s’agit du LSN de l’enregistrement immédiatement après le dernier enregistrement vidé.

Note 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, il retourne l’un des codes d’erreur définis dans Ntstatus.h.

Notes

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

Spécifications

   
Client minimal pris en charge Disponible dans Windows Server 2003 R2, Windows Vista et versions ultérieures de Windows.
Plateforme cible Bureau
En-tête wdm.h (include Wdm.h)
Bibliothèque Clfs.lib
DLL Clfs.sys
IRQL <= APC_LEVEL

Voir aussi

ClfsFlushBuffers