Функция TmRecoverTransactionManager (wdm.h)

Статья
07/16/2024

Подпрограмма 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 вызывающий объект указал значение, отличное отNULL для параметра TargetVirtualClock.
STATUS_TM_VOLATILE	Указанный объект диспетчера транзакций не содержит файл журнала, поэтому восстановление недоступно.
STATUS_UNSUCCESSFUL	Указанный объект диспетчера транзакций находится в непредвиденном состоянии.

Подпрограмма может возвращать другие значения NTSTATUS .

Замечания

Подпрограмма TmRecoverTransactionManager — это указательная версия подпрограммы ZwRecoverTransactionManager.

Вызов TmRecoverTransactionManager с Значение параметра TargetVirtualClockNULL функционально эквивалентно вызову ZwRecoverTransactionManager. Вызов TmRecoverTransactionManager с значением параметра, отличного отNULLTargetVirtualClock, функционально эквивалентен вызову ZwRollforwardTransactionManager.

Дополнительные сведения об операциях восстановления см. в обработке операций восстановления.

Сведения об использовании подпрограмм KTM TmXxx вместо подпрограмм ZwXxx см. в статье Использование подпрограмм TmXxxx.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Доступно в Windows Vista и более поздних версиях операционной системы.
целевая платформа	Всеобщий
заголовка	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
библиотеки	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL

См. также

ZwRecoverTransactionManager

ZwRollforwardTransactionManager

Поделиться через