Funzione ReadLogArchiveMetadata (clfsw32.h)
Copia un intervallo della visualizzazione archivio dei metadati nel buffer specificato.
CLFSUSER_API BOOL ReadLogArchiveMetadata(
[in] CLFS_LOG_ARCHIVE_CONTEXT pvArchiveContext,
[in] ULONG cbOffset,
[in] ULONG cbBytesToRead,
[in, out] PBYTE pbReadBuffer,
[out] PULONG pcbBytesRead
);
[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] cbOffset
Offset nei metadati in cui inizia la copia dei dati.
Nella prima chiamata a questa funzione specificare zero (0). Nelle chiamate successive specificare il valore restituito in pcbBytesRead.
[in] cbBytesToRead
Il numero di byte dello snapshot dei metadati deve essere copiato in pbReadBuffer.
Questo parametro non può essere zero (0).
[in, out] pbReadBuffer
Puntatore al buffer in cui viene copiato lo snapshot dei metadati.
[out] pcbBytesRead
Puntatore a una variabile che riceve il numero di byte copiati in pbReadBuffer.
Il numero di byte è sempre compreso tra zero (0) e cbBytesToRead.
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:
| 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 |