다음을 통해 공유

TxfLogReadRecords 함수(txfw32.h)

  • 아티클

[Microsoft는 개발자가 애플리케이션의 요구 사항을 달성하기 위해 대체 수단을 활용하는 것이 좋습니다. TxF가 개발된 많은 시나리오는 더 간단하고 쉽게 사용할 수 있는 기술을 통해 달성할 수 있습니다. 또한 이후 버전의 Microsoft Windows에서는 TxF를 사용하지 못할 수도 있습니다. TxF에 대한 자세한 내용과 대안은 트랜잭션 NTFS 사용에 대한 대안을 참조하세요.]

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

구문

BOOL TxfLogReadRecords(
  [in]  PVOID  TxfLogContext,
  [in]  ULONG  BufferLength,
  [out] PVOID  Buffer,
  [out] PULONG BytesUsed,
  [out] PULONG RecordCount
);

매개 변수

[in] TxfLogContext

컨텍스트에 대한 포인터입니다.

[in] BufferLength

출력 버퍼의 크기(바이트)입니다.

[out] Buffer

레코드를 수신하는 버퍼에 대한 포인터입니다. 자세한 내용은 TXF_LOG_RECORD_BASE 참조하세요.

[out] BytesUsed

출력 버퍼에 기록된 바이트 수입니다.

[out] RecordCount

출력 버퍼에 기록된 레코드 수입니다.

반환 값

함수가 성공하면 반환 값이 0이 아닙니다.

함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다. 가능한 오류 코드에는 다음이 포함됩니다.

반환 코드 설명
ERROR_INVALID_HANDLE
 복제 컨텍스트가 잘못되었습니다.
ERROR_MORE_DATA
 사용 가능한 레코드 중 일부가 버퍼에 복사되었습니다. 이 함수를 다시 호출하여 나머지 레코드를 검색합니다.
ERROR_INSUFFICIENT_BUFFER
 버퍼가 하나의 레코드도 포함할 만큼 크지 않습니다. BytesUsed가 0이 아닌 경우 다음 전체 레코드를 읽는 데 필요한 버퍼 크기를 나타내는 TXF_LOG_RECORD_BASE 구조를 복사할 공간이 충분했습니다.
ERROR_FILE_CORRUPT
 처리 중인 로그 파일의 형식을 인식할 수 없는 경우

요구 사항

요구 사항 값
지원되는 최소 클라이언트 WINDOWS Vista SP1 [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 txfw32.h
라이브러리 TxfW32.lib
DLL TxfW32.dll

추가 정보

TXF_LOG_RECORD_BASE