Fonction ClfsSetEndOfLog (wdm.h)

Article
02/29/2024

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 précédemment obtenu 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 retournée

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

Remarques

Le LSN fourni dans la valeur plsnEnd n’est pas validé. Il incombe à l’appelant de fournir un LSN valide ; c’est-à-dire qui est le 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 des 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 future et retourne toujours STATUS_NOT_SUPPORTED. Toutefois, la routine en mode utilisateur SetEndOfLog est actuellement prise en charge.

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