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

Подпрограмма ZwRecoverTransactionManager восстанавливает состояние объекта диспетчера транзакций (включая все транзакции, зачисления и диспетчеры ресурсов) из сведений о восстановлении, которые содержатся в потоке журнала.

Синтаксис

NTSYSCALLAPI NTSTATUS ZwRecoverTransactionManager(
  [in] HANDLE TransactionManagerHandle
);

Параметры

[in] TransactionManagerHandle

Дескриптор объекта диспетчера транзакций , полученный при предыдущем вызове ZwCreateTransactionManager или ZwOpenTransactionManager. Дескриптор должен иметь TRANSACTIONMANAGER_RECOVER доступ к объекту .

Возвращаемое значение

ZwRecoverTransactionManager возвращает STATUS_SUCCESS, если операция выполнена успешно. В противном случае эта подпрограмма может возвращать одно из следующих значений:

Код возврата	Описание
STATUS_OBJECT_TYPE_MISMATCH	Указанный дескриптор не является дескриптором для объекта диспетчера транзакций.
STATUS_INVALID_HANDLE	Недопустимый дескриптор объекта.
STATUS_ACCESS_DENIED	Вызывающий объект не имеет соответствующего доступа к объекту диспетчера транзакций.
STATUS_TM_VOLATILE	Объект диспетчера транзакций является переменным и, следовательно, его транзакции не могут быть восстановлены.
STATUS_UNSUCCESSFUL	Объект диспетчера транзакций не находится в состоянии, позволяющем выполнить восстановление.

 

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

Комментарии

Подпрограмма ZwRecoverTransactionManager пытается восстановить состояние объекта диспетчера транзакций, включая все транзакции, зачисления и диспетчеры ресурсов, из сведений о восстановлении, которые содержатся в потоке журнала объекта, начиная с последней области перезапуска , созданной KTM, и заканчивая в конце потока.

Для восстановления до определенного виртуального времени используйте подпрограмму ZwRollforwardTransactionManager вместо ZwRecoverTransactionManager.

Компонент TPS должен вызвать ZwRecoverTransactionManager после вызова ZwCreateTransactionManager или ZwOpenTransactionManager.

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

NtRecoverTransactionManager и ZwRecoverTransactionManager — это две версии одной и той же подпрограммы windows Native System Services.

Для вызовов из драйверов режима ядра версии NtXxx и ZwXxx подпрограммы собственных системных служб Windows могут вести себя по-разному, так как они обрабатывают и интерпретируют входные параметры. Дополнительные сведения о связи между версиями процедуры NtXxx и ZwXxx см. в разделе Использование версий Nt и Zw для процедур собственных системных служб.

Требования

Требование	Значение
Минимальная версия клиента	Доступно в Windows Vista и более поздних версиях операционной системы.
Целевая платформа	Универсальное
Верхняя часть	wdm.h (включая Wdm.h, Ntifs.h)
Библиотека	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
Правила соответствия DDI	HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm)

См. также раздел

TmRecoverTransactionManager

Использование версий Nt и Zw собственных процедур системных служб

ZwCreateTransactionManager

ZwOpenTransactionManager

ZwRollforwardTransactionManager