Fonction SetLogArchiveTail (clfsw32.h)

Définit le dernier numéro de séquence de journal archivé (LSN) ou la fin d’archive d’un journal archivable.

Syntaxe

CLFSUSER_API BOOL SetLogArchiveTail(
  [in]                HANDLE    hLog,
  [in]                PCLFS_LSN plsnArchiveTail,
  [in, out, optional] LPVOID    pReserved
);

Paramètres

[in] hLog

Handle du journal obtenu à partir de CreateLogFile.

Le handle de journal peut faire référence à un journal dédié ou multiplexé.

[in] plsnArchiveTail

Pointeur vers une structure CLFS_LSN qui spécifie un LSN physique valide dans le journal.

Note Pour les handles d’un journal physique ou d’un flux de journal, plsnArchiveTail est un LSN physique, car il fait référence à une adresse d’enregistrement dans le journal physique.

 

[in, out, optional] pReserved

Ce paramètre est réservé et doit être défini sur NULL.

Valeur retournée

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

La liste suivante identifie les codes d’erreur possibles :

Remarques

S’il existe des contextes d’archivage obtenus à partir de PrepareLogArchive qui ne sont pas terminés par TerminateLogArchive, la modification n’entre pas en vigueur tant que toutes les archives ne sont pas terminées. Bien qu’il existe des contextes d’archivage en suspens, seule la plus grande queue d’archive est appliquée.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 R2 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	clfsw32.h
Bibliothèque	Clfsw32.lib
DLL	Clfsw32.dll

Voir aussi

CLFS_LSN

Fonctions courantes du système de fichiers journaux

OVERLAPPED

RemoveLogContainer

RemoveLogContainerSet