Funzione GetNextLogArchiveExtent (clfsw32.h)

Recupera il set successivo di extent di archivio in un contesto di archivio dei log. Il contesto di archiviazione del log descrive un set contiguo di extent di file che si estende sullo snapshot del log attivo acquisito dalle acquisizioni PrepareLogArchive . GetNextLogArchiveExtent mantiene un cursore nel set ordinato di descrittori di archivio log in modo che le chiamate successive consentano a un'applicazione di scorrere l'intero set.

Sintassi

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

Parametri

[in] pvArchiveContext

Puntatore a un contesto di archivio ottenuto da una chiamata a PrepareLogArchive.

Il contesto mantiene lo stato del cursore, che consente l'iterazione tramite il set di extent di file nell'archivio. Il client di archiviazione è responsabile della deallocazione del contesto tramite la funzione TerminateLogArchive .

[in, out] rgadExtent

Matrice allocata dal client di strutture CLFS_ARCHIVE_DESCRIPTOR da compilare da questa funzione.

[in] cDescriptors

Numero di elementi nella matrice rgadExtent .

Questo valore è il numero massimo di descrittori di archivio che possono essere recuperati da questa funzione.

[out] pcDescriptorsReturned

Numero di descrittori nella matrice rgadExtent compilati da questa funzione.

Se questo valore è minore di cDescriptor, il set di descrittori viene esaurito e il client di archiviazione può terminare l'iterazione tramite il set di descrittori ordinati. Altre chiamate a questa funzione hanno esito negativo con ERROR_NO_MORE_ENTRIES.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero (0). Per informazioni dettagliate sull'errore, chiamare GetLastError. L'elenco seguente identifica i possibili codici di errore:

Requisiti

Requisito Valore
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2003 R2 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione clfsw32.h
Libreria Clfsw32.lib
DLL Clfsw32.dll

Vedi anche

CLFS_ARCHIVE_DESCRIPTOR

Funzioni comuni del file system di log