Fonction ClfsAdvanceLogBase (wdm.h)

  • Article

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 précédemment obtenu 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. En outre, 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 retournée

ClfsAdvanceLogBase retourne STATUS_SUCCESS si elle réussit ; sinon, il 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 dans un flux en même temps, appelez ClfsWriteRestartArea.

Dans la mesure du possible, CLFS évite d’écrire des enregistrements de journal mis en file d’attente qui ont des LSN inférieurs au nouveau LSN de base dans un stockage stable.

ClfsAdvanceLogBase ne case activée pas pour voir si le LSN fourni dans plsnBase est en fait le LSN de l’un des enregistrements du flux. Si l’appelant définit plsnBase sur 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 inutile.

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

Configuration requise

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

Voir aussi

ClfsWriteRestartArea