TmRecoverTransactionManager 함수(wdm.h)

TmRecoverTransactionManager 루틴은 로그 스트림에 있는 복구 정보에서 트랜잭션 관리자 개체의 상태(모든 트랜잭션, 인리스트먼트 및 리소스 관리자 포함)를 다시 구성합니다.

구문

NTSTATUS TmRecoverTransactionManager(
  [in] PKTM           Tm,
  [in] PLARGE_INTEGER TargetVirtualClock
);

매개 변수

[in] Tm

트랜잭션 관리자 개체에 대한 포인터입니다. 이 포인터를 가져오려면 TPS 구성 요소가 ObReferenceObjectByHandle 을 호출하고 ZwCreateTransactionManager 또는 ZwOpenTransactionManager 에 대한 이전 호출이 제공한 개체 핸들을 제공해야 합니다.

[in] TargetVirtualClock

가상 클록 값에 대한 포인터입니다. 이 매개 변수는 선택 사항이며 NULL일 수 있습니다. 이 매개 변수에 대한 자세한 내용은 다음 설명 섹션을 참조하세요. Windows Vista의 경우 이 매개 변수는 NULL이어야 합니다.

반환 값

TmRecoverTransactionManager 는 작업이 성공하면 STATUS_SUCCESS 반환합니다. 그렇지 않으면 이 루틴이 다음 값 중 하나를 반환할 수 있습니다.

반환 코드	설명
STATUS_NOT_IMPLEMENTED	Windows Vista의 경우 호출자는 TargetVirtualClock 매개 변수에 NULL이 아닌 값을 지정했습니다.
STATUS_TM_VOLATILE	지정된 트랜잭션 관리자 개체에 로그 파일이 없으므로 복구를 사용할 수 없습니다.
STATUS_UNSUCCESSFUL	지정된 트랜잭션 관리자 개체가 예기치 않은 상태입니다.

 

루틴은 다른 NTSTATUS 값을 반환할 수 있습니다.

설명

TmRecoverTransactionManager 루틴은 ZwRecoverTransactionManager 루틴의 포인터 기반 버전입니다.

TargetVirtualClock 매개 변수 값이 NULL인 TmRecoverTransactionManager를 호출하는 것은 ZwRecoverTransactionManager를 호출하는 것과 기능적으로 동일합니다. NULL이 아닌 TargetVirtualClock 매개 변수 값을 사용하여 TmRecoverTransactionManager를 호출하는 것은 ZwRollforwardTransactionManager를 호출하는 것과 기능적으로 동일합니다.

복구 작업에 대한 자세한 내용은 복구 작업 처리를 참조하세요.

Zw Xxx 루틴 대신 KTM의 TmXxx 루틴을 사용하는 시기에 대한 자세한 내용은 TmXxx 루틴 사용을 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista 이상 운영 체제 버전에서 사용할 수 있습니다.
대상 플랫폼	유니버설
헤더	wdm.h(Wdm.h, Ntddk.h, Ntifs.h 포함)
라이브러리	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL

추가 정보

ZwRecoverTransactionManager

ZwRollforwardTransactionManager