ReadLogArchiveMetadata function

Copies a range of the archive view of the metadata to the specified buffer.

Syntax

CLFSUSER_API BOOL ReadLogArchiveMetadata(
  IN CLFS_LOG_ARCHIVE_CONTEXT pvArchiveContext,
  IN ULONG                    cbOffset,
  IN ULONG                    cbBytesToRead,
  IN OUT PBYTE                pbReadBuffer,
  OUT PULONG                  pcbBytesRead
);

Parameters

pvArchiveContext

A pointer to an archive context that is obtained by a call to PrepareLogArchive.

The context maintains the cursor state, which allows iteration through the set of file extents in the archive. The archive client is responsible for deallocating the context by using the TerminateLogArchive function.

cbOffset

The offset in the metadata where data copying starts.

On the first call to this function, specify zero (0). On subsequent calls, specify the value that is returned in pcbBytesRead.

cbBytesToRead

The number of bytes of the metadata snapshot should be copied into pbReadBuffer.

This parameter cannot be zero (0).

pbReadBuffer

A pointer to the buffer where the metadata snapshot is copied.

pcbBytesRead

A pointer to a variable that receives the number of bytes that are copied to pbReadBuffer.

The number of bytes is always between zero (0) and cbBytesToRead.

Return Value

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero (0). To get extended error information, call GetLastError. The following list identifies the possible error codes:

Requirements

   
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2003 R2 [desktop apps only]
Target Platform Windows
Header clfsw32.h
Library Clfsw32.lib
DLL Clfsw32.dll

See Also

Common Log File System Functions

PrepareLogArchive

TerminateLogArchive