Metodo ILog::ReadRecordPrefix (txlogpub.h)

Articolo
08/26/2023

Legge una parte iniziale di un record dal log.

Sintassi

HRESULT ReadRecordPrefix(
  [in]      LSN   lsnToRead,
  [in, out] LSN   *plsnPrev,
  [in, out] LSN   *plsnNext,
  [out]     BYTE  *pbData,
  [in, out] ULONG *pcbData,
  [out]     ULONG *pcbRecord
);

Parametri

[in] lsnToRead

LSN del record da leggere.

[in, out] plsnPrev

Puntatore all'LSN del record precedente (il record precede immediatamente il record da leggere). È possibile passare NULL se l'LSN del record precedente non è necessario. Questo parametro è 0 se nel log non è presente alcun record precedente o se si verifica un errore.

[in, out] plsnNext

Puntatore all'LSN del record successivo (il record segue immediatamente il record da leggere). È possibile passare NULL se l'LSN del record successivo non è necessario. Questo parametro è MAXLSN (0x7FFFFFFFFFFFFFFF) se nel log non è presente alcun record successivo. Questo parametro è 0 se si verifica un errore.

[out] pbData

Puntatore a un buffer in cui devono essere letti i dati del record.

[in, out] pcbData

Puntatore a una variabile che contiene le dimensioni in byte del buffer in input e conterrà le dimensioni in byte dei dati del record letti al ritorno.

[out] pcbRecord

Puntatore a una variabile che conterrà le dimensioni in byte dell'intero record restituito. È possibile passare NULL se le dimensioni dell'intero record non sono necessarie.

Valore restituito

Questo metodo può restituire i valori seguenti, nonché altri valori HRESULT .

Codice restituito	Descrizione
S_OK	Il record è stato letto correttamente dal log.
XACT_E_INVALIDLSN	lsnToRead non rientra nei limiti correnti del log. Vedere ILog::GetLogLimits.
E_INVALIDARG	lsnToRead si trova entro i limiti correnti del log, ma non è l'LSN di un record nel log.

Commenti

Anche se i record aggiunti al log usando ILog::AppendRecord possono essere concatenati da più BLOBs, ReadRecordPrefix restituisce il record come singolo BLOB opaco di dati. ILog non fornisce alcun metodo per estrarre singoli BLOB dal record. È responsabilità del chiamante analizzare i dati nei record restituiti da ReadRecordPrefix.

Requisiti


Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	txlogpub.h

Vedi anche

Ilog

Condividi tramite