GetNextLogArchiveExtent-Funktion (clfsw32.h)
Ruft den nächsten Satz von Archivausdehnungen in einem Protokollarchivkontext ab. Der Protokollarchivkontext beschreibt einen zusammenhängenden Satz von Dateiausdehnungen, die die Momentaufnahme des aktiven Protokolls umfassen, das von PrepareLogArchive-Aufzeichnungen erfasst wird. GetNextLogArchiveExtent verwaltet einen Cursor im geordneten Satz von Protokollarchivdeskriptoren, sodass nachfolgende Aufrufe einer Anwendung das Durchlaufen des gesamten Satzes ermöglichen.
Syntax
CLFSUSER_API BOOL GetNextLogArchiveExtent(
[in] CLFS_LOG_ARCHIVE_CONTEXT pvArchiveContext,
[in, out] CLFS_ARCHIVE_DESCRIPTOR [] rgadExtent,
[in] ULONG cDescriptors,
[out] PULONG pcDescriptorsReturned
);
Parameter
[in] pvArchiveContext
Ein Zeiger auf einen Archivkontext, der durch einen Aufruf von PrepareLogArchive abgerufen wird.
Der Kontext behält den Cursorzustand bei, der eine Iteration durch den Satz von Dateiblöcken im Archiv ermöglicht. Der Archivclient ist für die Aufhebung der Zuordnung des Kontexts mithilfe der TerminateLogArchive-Funktion verantwortlich.
[in, out] rgadExtent
Ein vom Client zugewiesenes Array von CLFS_ARCHIVE_DESCRIPTOR Strukturen, die von dieser Funktion ausgefüllt werden sollen.
[in] cDescriptors
Die Anzahl der Elemente im rgadExtent-Array .
Dieser Wert ist die maximale Anzahl von Archivdeskriptoren, die von dieser Funktion abgerufen werden können.
[out] pcDescriptorsReturned
Die Anzahl der Deskriptoren im rgadExtent-Array , die von dieser Funktion ausgefüllt werden.
Wenn dieser Wert kleiner als cDescriptors ist, ist der Satz von Deskriptoren erschöpft, und der Archivclient kann die Iteration über den geordneten Deskriptorsatz beenden. Weitere Aufrufe dieser Funktion schlagen mit ERROR_NO_MORE_ENTRIES fehl.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.
Wenn die Funktion fehlschlägt, ist der Rückgabewert 0 (null). Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf. Die folgende Liste identifiziert die möglichen Fehlercodes:
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 R2 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | clfsw32.h |
| Bibliothek | Clfsw32.lib |
| DLL | Clfsw32.dll |