ILog::ReadRecordPrefix 메서드(txlogpub.h)

로그에서 레코드의 초기 부분을 읽습니다.

구문

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

매개 변수

[in] lsnToRead

읽을 레코드의 LSN입니다.

[in, out] plsnPrev

이전 레코드의 LSN(읽을 레코드 바로 앞의 레코드)에 대한 포인터입니다. 이전 레코드의 LSN이 필요하지 않은 경우 NULL 을 전달할 수 있습니다. 이 매개 변수는 로그에 이전 레코드가 없거나 오류가 발생하는 경우 0입니다.

[in, out] plsnNext

다음 레코드의 LSN에 대한 포인터입니다(읽을 레코드 바로 뒤의 레코드). 다음 레코드의 LSN이 필요하지 않은 경우 NULL 을 전달할 수 있습니다. 로그에 다음 레코드가 없는 경우 이 매개 변수는 MAXLSN(0x7FFFFFFFFFFFFFFF)입니다. 오류가 발생하면 이 매개 변수는 0입니다.

[out] pbData

레코드 데이터를 읽을 버퍼에 대한 포인터입니다.

[in, out] pcbData

입력 시 버퍼의 크기(바이트)를 포함하고 반환 시 읽은 레코드 데이터의 크기(바이트)를 포함하는 변수에 대한 포인터입니다.

[out] pcbRecord

반환 시 전체 레코드의 크기(바이트)를 포함하는 변수에 대한 포인터입니다. 전체 레코드의 크기가 필요하지 않은 경우 NULL 을 전달할 수 있습니다.

반환 값

이 메서드는 다음 값과 다른 HRESULT 값을 반환할 수 있습니다.

설명

ILog::AppendRecord를 사용하여 로그에 추가된 레코드가 여러 BLOB에서 연결될 수 있지만 ReadRecordPrefix는 레코드를 단일 불투명 데이터 Blob으로 반환합니다. ILog 는 레코드에서 개별 BLOB을 추출하는 메서드를 제공하지 않습니다. ReadRecordPrefix에서 반환된 레코드의 데이터를 구문 분석하는 것은 호출자의 책임입니다.

요구 사항

추가 정보

Ilog