Método ILog::ReadRecordPrefix (txlogpub.h)

  • Artigo

Lê uma parte inicial de um registro do log.

Sintaxe

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

Parâmetros

[in] lsnToRead

O LSN do registro a ser lido.

[in, out] plsnPrev

Um ponteiro para o LSN do registro anterior (o registro imediatamente anterior ao registro a ser lido). Você poderá passar NULL se o LSN do registro anterior não for necessário. Esse parâmetro será 0 se não houver nenhum registro anterior no log ou se ocorrer um erro.

[in, out] plsnNext

Um ponteiro para o LSN do próximo registro (o registro imediatamente após o registro a ser lido). Você poderá passar NULL se o LSN do próximo registro não for necessário. Esse parâmetro será MAXLSN (0x7FFFFFFFFFFFFFFF) se não houver nenhum próximo registro no log. Esse parâmetro será 0 se ocorrer um erro.

[out] pbData

Um ponteiro para um buffer no qual os dados de registro devem ser lidos.

[in, out] pcbData

Um ponteiro para uma variável que contém o tamanho em bytes do buffer na entrada e conterá o tamanho em bytes dos dados de registro lidos no retorno.

[out] pcbRecord

Um ponteiro para uma variável que conterá o tamanho em bytes de todo o registro no retorno. Você poderá passar NULL se o tamanho de todo o registro não for necessário.

Valor retornado

Esse método pode retornar os valores a seguir, bem como outros valores HRESULT .

Código de retorno Descrição
S_OK
 O registro foi lido com êxito no log.
XACT_E_INVALIDLSN
 LsnToRead está fora dos limites atuais do log. Consulte ILog::GetLogLimits.
E_INVALIDARG
 LsnToRead está dentro dos limites atuais do log, mas não é o LSN de um registro no log.

Comentários

Embora os registros anexados ao log usando ILog::AppendRecord possam ser concatenados de vários BLOBs, ReadRecordPrefix retorna o registro como um único blob opaco de dados. O ILog não fornece nenhum método para extrair BLOBs individuais do registro. É responsabilidade do chamador analisar os dados em registros retornados por ReadRecordPrefix.

Requisitos

   
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho txlogpub.h

Confira também

Ilog