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 |