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 |
---|---|
|
로그에서 레코드를 성공적으로 읽었습니다. |
|
lsnToRead 가 로그의 현재 제한을 벗어났습니다. ILog::GetLogLimits를 참조하세요. |
|
lsnToRead 는 로그의 현재 제한 내에 있지만 로그에 있는 레코드의 LSN이 아닙니다. |
|
메모리 부족으로 인해 레코드가 반환되지 않았습니다. |
설명
ILog::AppendRecord를 사용하여 로그에 추가된 레코드가 여러 BLOB에서 연결될 수 있지만 ReadRecord는 레코드를 단일 불투명 데이터 Blob으로 반환합니다. ILog 는 레코드에서 개별 BLOB을 추출하는 메서드를 제공하지 않습니다. ReadRecord에서 반환된 레코드의 데이터를 구문 분석하는 것은 호출자의 책임입니다.
발신자에 대한 참고 사항
로그에 매우 큰 레코드가 포함된 경우 ReadRecord 가 레코드 데이터에 충분한 메모리를 할당할 수 없기 때문에 이 메서드가 실패할 수 있습니다. 레코드 크기가 제한되거나 레코드의 초기 부분만 필요한 경우 ILog::ReadRecordPrefix를 호출하는 것이 더 효율적일 수 있습니다.요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | Windows XP [데스크톱 앱만 해당] |
지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱만 해당] |
대상 플랫폼 | Windows |
헤더 | txlogpub.h |