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

  • Artículo

Lee una parte inicial de un registro del registro.

Sintaxis

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

LSN del registro que se va a leer.

[in, out] plsnPrev

Puntero al LSN del registro anterior (el registro inmediatamente anterior al registro que se va a leer). Puede pasar NULL si el LSN del registro anterior no es necesario. Este parámetro es 0 si no hay ningún registro anterior en el registro o si se produce un error.

[in, out] plsnNext

Puntero al LSN del siguiente registro (el registro inmediatamente después del registro que se va a leer). Puede pasar NULL si el LSN del siguiente registro no es necesario. Este parámetro es MAXLSN (0x7FFFFFFFFFFFFFFF) si no hay ningún registro siguiente en el registro. Este parámetro es 0 si se produce un error.

[out] pbData

Puntero a un búfer en el que se van a leer los datos del registro.

[in, out] pcbData

Puntero a una variable que contiene el tamaño en bytes del búfer en la entrada y contendrá el tamaño en bytes de los datos de registro leídos al devolver.

[out] pcbRecord

Puntero a una variable que contendrá el tamaño en bytes de todo el registro al devolver. Puede pasar NULL si no se necesita el tamaño de todo el registro.

Valor devuelto

Este método puede devolver los valores siguientes, así como otros valores HRESULT .

Código devuelto Descripción
S_OK
 El registro se leyó correctamente del registro.
XACT_E_INVALIDLSN
 lsnToRead está fuera de los límites actuales del registro. Consulte ILog::GetLogLimits.
E_INVALIDARG
 lsnToRead está dentro de los límites actuales del registro, pero no es el LSN de un registro en el registro.

Comentarios

Aunque los registros anexados al registro mediante ILog::AppendRecord se pueden concatenar desde varios BLOB, ReadRecordPrefix devuelve el registro como un único blob opaco de datos. ILog no proporciona ningún método para extraer blobs individuales del registro. Es responsabilidad del autor de la llamada analizar los datos de los registros devueltos por ReadRecordPrefix.

Requisitos

   
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado txlogpub.h

Consulte también

Ilog