ReadLogArchiveMetadata-Funktion (clfsw32.h)

Kopiert einen Bereich der Archivansicht der Metadaten in den angegebenen Puffer.

Syntax

CLFSUSER_API BOOL ReadLogArchiveMetadata(
  [in]      CLFS_LOG_ARCHIVE_CONTEXT pvArchiveContext,
  [in]      ULONG                    cbOffset,
  [in]      ULONG                    cbBytesToRead,
  [in, out] PBYTE                    pbReadBuffer,
  [out]     PULONG                   pcbBytesRead
);

Parameter

[in] pvArchiveContext

Ein Zeiger auf einen Archivkontext, der durch einen Aufruf von PrepareLogArchive abgerufen wird.

Der Kontext behält den Cursorzustand bei, der die Iteration durch den Satz von Dateiausdehnungen im Archiv ermöglicht. Der Archivclient ist für die Zuordnung des Kontexts mithilfe der Funktion TerminateLogArchive verantwortlich.

[in] cbOffset

Der Offset in den Metadaten, in denen das Kopieren von Daten beginnt.

Geben Sie beim ersten Aufruf dieser Funktion null (0) an. Geben Sie bei nachfolgenden Aufrufen den Wert an, der in pcbBytesRead zurückgegeben wird.

[in] cbBytesToRead

Die Anzahl der Bytes der Metadaten Momentaufnahme in pbReadBuffer kopiert werden sollte.

Dieser Parameter darf nicht null (0) sein.

[in, out] pbReadBuffer

Ein Zeiger auf den Puffer, in den die Metadaten Momentaufnahme kopiert werden.

[out] pcbBytesRead

Ein Zeiger auf eine Variable, die die Anzahl der Bytes empfängt, die in pbReadBuffer kopiert werden.

Die Anzahl der Bytes liegt immer zwischen null (0) und cbBytesToRead.

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. In der folgenden Liste werden die möglichen Fehlercodes identifiziert:

Anforderungen

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

Weitere Informationen

Allgemeine Protokolldateisystemfunktionen

PrepareLogArchive

TerminateLogArchive