Partager via


ClfsSetEndOfLog, fonction (wdm.h)

La routine ClfsSetEndOfLog tronque un flux CLFS.

Syntaxe

CLFSUSER_API NTSTATUS ClfsSetEndOfLog(
  [in] PLOG_FILE_OBJECT plfoLog,
  [in] PCLFS_LSN        plsnEnd
);

Paramètres

[in] plfoLog

Pointeur vers une structure LOG_FILE_OBJECT qui représente un flux CLFS. Ce flux doit être le seul flux d’un journal dédié. L’appelant a obtenu précédemment ce pointeur en appelant ClfsCreateLogFile.

[in] plsnEnd

Pointeur vers une structure CLFS_LSN qui fournit le LSN de l’enregistrement qui doit devenir le dernier enregistrement du flux. Il doit s’agir du LSN exact de l’un des enregistrements du flux.

Valeur de retour

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

Remarques

Le LSN fourni dans la valeur plsnEnd n’est pas validée. Il incombe à l’appelant de fournir un LSN valide ; c’est-à-dire un LSN exact d’un enregistrement dans le flux.

Ce flux représenté par plfoLog doit provenir d’un journal dédié. Cette routine ne prend pas en charge les flux provenant de journaux multiplexés.

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

La routine en mode noyau ClfsSetEndOfLog est réservée à une utilisation ultérieure et retourne toujours STATUS_NOT_SUPPORTED. Toutefois, la routine en mode utilisateur SetEndOfLog est actuellement prise en charge.

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

CLFS_LSN

ClfsAdvanceLogBase

ClfsCreateLogFile

ClfsSetArchiveTail

ClfsSetEndOfLog

LOG_FILE_OBJECT