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 |