GetNextLogArchiveExtent, fonction (clfsw32.h)

Récupère l’ensemble suivant d’étendues d’archive dans un contexte d’archivage de journal. Le contexte d’archivage des journaux décrit un ensemble contigu d’étendues de fichiers qui couvrent la instantané du journal actif capturé par les captures PrepareLogArchive. GetNextLogArchiveExtent conserve un curseur dans l’ensemble ordonné de descripteurs d’archive de journal afin que les appels suivants permettent à une application d’itérer dans l’ensemble.

Syntaxe

CLFSUSER_API BOOL GetNextLogArchiveExtent(
  [in]      CLFS_LOG_ARCHIVE_CONTEXT   pvArchiveContext,
  [in, out] CLFS_ARCHIVE_DESCRIPTOR [] rgadExtent,
  [in]      ULONG                      cDescriptors,
  [out]     PULONG                     pcDescriptorsReturned
);

Paramètres

[in] pvArchiveContext

Pointeur vers un contexte d’archive obtenu par un appel à PrepareLogArchive.

Le contexte conserve l’état du curseur, ce qui permet l’itération via l’ensemble d’étendues de fichier dans l’archive. Le client d’archive est responsable de la désaffectation du contexte à l’aide de la fonction TerminateLogArchive .

[in, out] rgadExtent

Tableau alloué par le client de structures CLFS_ARCHIVE_DESCRIPTOR à remplir par cette fonction.

[in] cDescriptors

Nombre d’éléments dans le tableau rgadExtent .

Cette valeur est le nombre maximal de descripteurs d’archive qui peuvent être récupérés par cette fonction.

[out] pcDescriptorsReturned

Nombre de descripteurs dans le tableau rgadExtent qui sont renseignés par cette fonction.

Si cette valeur est inférieure à cDescriptors, le jeu de descripteurs est épuisé et le client d’archive peut mettre fin à l’itération via le jeu de descripteur ordonné. D’autres appels à cette fonction échouent avec ERROR_NO_MORE_ENTRIES.

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 (0). Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError. La liste suivante identifie les codes d’erreur possibles :

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_ARCHIVE_DESCRIPTOR

Fonctions courantes du système de fichiers journaux