Funzione TxfLogReadRecords (txfw32.h)

Articolo
03/03/2024

[Microsoft consiglia vivamente agli sviluppatori di usare mezzi alternativi per raggiungere le esigenze dell'applicazione. Molti scenari sviluppati da TxF possono essere ottenuti tramite tecniche più semplici e più leggibili. Inoltre, TxF potrebbe non essere disponibile nelle versioni future di Microsoft Windows. Per altre informazioni e alternative a TxF, vedere Alternative all'uso di NTFS transazionale.

Legge i record di ripristino dal log.

Sintassi

BOOL TxfLogReadRecords(
  [in]  PVOID  TxfLogContext,
  [in]  ULONG  BufferLength,
  [out] PVOID  Buffer,
  [out] PULONG BytesUsed,
  [out] PULONG RecordCount
);

Parametri

[in] TxfLogContext

Puntatore al contesto.

[in] BufferLength

Dimensioni in byte del buffer di output.

[out] Buffer

Puntatore al buffer che riceve i record. Per altre informazioni, vedere TXF_LOG_RECORD_BASE.

[out] BytesUsed

Numero di byte scritti nel buffer di output.

[out] RecordCount

Numero di record scritti nel buffer di output.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError. I codici di errore possibili includono quanto segue.

Codice restituito	Descrizione
ERROR_INVALID_HANDLE	Il contesto di replica non è valido.
ERROR_MORE_DATA	Alcuni dei record disponibili sono stati copiati nel buffer. Chiamare di nuovo questa funzione per recuperare il resto dei record.
ERROR_INSUFFICIENT_BUFFER	Il buffer non è abbastanza grande per contenere anche un record. Se BytesUsed è diverso da zero, c'era spazio sufficiente per copiare la struttura TXF_LOG_RECORD_BASE , che indica la dimensione del buffer necessaria per leggere il record completo successivo.
ERROR_FILE_CORRUPT	Il formato del file di log elaborato non viene riconosciuto.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista con SP1 [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	txfw32.h
Libreria	TxfW32.lib
DLL	TxfW32.dll

Vedi anche

TXF_LOG_RECORD_BASE

Condividi tramite