Partager via


ClfsAdvanceLogBase, fonction (wdm.h)

La routine ClfsAdvanceLogBase définit le LSN de base d’un flux CLFS.

Syntaxe

CLFSUSER_API NTSTATUS ClfsAdvanceLogBase(
  [in, out] PVOID     pvMarshalContext,
  [in]      PCLFS_LSN plsnBase,
  [in]      ULONG     fFlags
);

Paramètres

[in, out] pvMarshalContext

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

[in] plsnBase

Pointeur vers une structure CLFS_LSN qui contient le nouveau LSN de base. Ce paramètre doit être le LSN de l’un des enregistrements du flux. De plus, ce paramètre doit être supérieur ou égal au LSN de base actuel du flux et inférieur ou égal au dernier LSN actuel du flux.

[in] fFlags

Ce paramètre est réservé à l’utilisation du système. Les appelants doivent définir ce paramètre sur zéro.

Valeur de retour

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

Remarques

ClfsAdvanceLogBase n’écrit aucun enregistrement dans le journal CLFS ; les seules mises à jour du journal se trouvent dans les métadonnées. Si vous souhaitez mettre à jour le LSN de base et écrire un enregistrement de redémarrage en même temps dans un flux, appelez ClfsWriteRestartArea.

Dans la mesure du possible, CLFS évite d’écrire des enregistrements de journal mis en file d’attente dont les noms LSN sont inférieurs à la nouvelle LSN de base dans un stockage stable.

ClfsAdvanceLogBase ne vérifie pas si le LSN fourni dans plsnBase est en fait le LSN de l’un des enregistrements du flux. Si l’appelant définit plsnBase à un LSN qui n’est pas le LSN de l’un des enregistrements du flux, le LSN de base du flux est défini sur une valeur sans signification.

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

Exigences

Exigence Valeur
client minimum pris en charge Disponible dans Windows Server 2003 R2, Windows Vista et versions ultérieures de Windows.
plateforme cible Bureau
d’en-tête wdm.h (include Wdm.h)
bibliothèque Clfs.lib
DLL Clfs.sys
IRQL <= APC_LEVEL

Voir aussi

ClfsWriteRestartArea