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 |