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

  • 아티클

로그에서 레코드를 읽습니다.

구문

HRESULT ReadRecord(
  [in]      LSN   lsnToRead,
  [in, out] LSN   *plsnPrev,
  [in, out] LSN   *plsnNext,
  [out]     BYTE  **ppbData,
  [out]     ULONG *pcbData
);

매개 변수

[in] lsnToRead

읽을 레코드의 LSN입니다.

[in, out] plsnPrev

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

[in, out] plsnNext

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

[out] ppbData

반환 시 레코드 데이터에 대한 포인터를 포함하는 변수에 대한 포인터입니다. 이 데이터의 메모리는 ReadRecord 에 의해 할당되고 호출자가 해제합니다( CoTaskMemFree 참조). 오류가 발생하는 경우 이 매개 변수는 NULL 입니다.

[out] pcbData

반환 시 레코드 데이터의 크기(바이트)를 수신하는 변수에 대한 포인터입니다.

반환 값

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

반환 코드 Description
S_OK
 로그에서 레코드를 성공적으로 읽었습니다.
XACT_E_INVALIDLSN
 lsnToRead 가 로그의 현재 제한을 벗어났습니다. ILog::GetLogLimits를 참조하세요.
E_INVALIDARG
 lsnToRead 는 로그의 현재 제한 내에 있지만 로그에 있는 레코드의 LSN이 아닙니다.
E_OUTOFMEMORY
 메모리 부족으로 인해 레코드가 반환되지 않았습니다.

설명

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

발신자에 대한 참고 사항

로그에 매우 큰 레코드가 포함된 경우 ReadRecord 가 레코드 데이터에 충분한 메모리를 할당할 수 없기 때문에 이 메서드가 실패할 수 있습니다. 레코드 크기가 제한되거나 레코드의 초기 부분만 필요한 경우 ILog::ReadRecordPrefix를 호출하는 것이 더 효율적일 수 있습니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 txlogpub.h

추가 정보

Ilog