Функция NtRecoverTransactionManager (wdm.h)
Подпрограмма ZwRecoverTransactionManager восстанавливает состояние объекта диспетчера транзакций (включая все транзакции, перечисления и диспетчеры ресурсов) из сведений о восстановлении, входящих в поток журнала.
Синтаксис
__kernel_entry NTSYSCALLAPI NTSTATUS NtRecoverTransactionManager(
[in] HANDLE TransactionManagerHandle
);
Параметры
[in] TransactionManagerHandle
Дескриптор объекта диспетчера транзакций , который был получен предыдущим вызовом ZwCreateTransactionManager или ZwOpenTransactionManager. Дескриптор должен иметь TRANSACTIONMANAGER_RECOVER доступ к объекту.
Возвращаемое значение
ZwRecoverTransactionManager возвращает STATUS_SUCCESS, если операция выполнена успешно. В противном случае эта подпрограмма может вернуть одно из следующих значений:
| Возвращаемый код | Описание |
|---|---|
|
Указанный дескриптор не является дескриптором объекта диспетчера транзакций. |
|
Дескриптор объекта недопустим. |
|
Вызывающий объект не имеет соответствующего доступа к объекту диспетчера транзакций. |
|
Объект диспетчера транзакций является переменным, поэтому его транзакции не могут быть восстановлены. |
|
Объект диспетчера транзакций не находится в состоянии, позволяющем восстановить. |
Подпрограмма может возвращать другие значения NTSTATUS .
Замечания
Подпрограмма ZwRecoverTransactionManager пытается восстановить состояние объекта диспетчера транзакций, включая все транзакции, перечисления и диспетчеры ресурсов, от сведений о восстановлении, которые входят в поток журнала объекта, начиная с последней области перезапуска созданной KTM и заканчивающейся в конце потока.
Чтобы восстановить до определенного виртуального времени, используйте подпрограмму ZwRollforwardTransactionManager вместо ZwRecoverTransactionManager.
Компонент TPS должен вызывать ZwRecoverTransactionManager после вызова ZwCreateTransactionManager или ZwOpenTransactionManager.
Дополнительные сведения об операциях восстановления см. в обработке операций восстановления.
NtRecoverTransactionManager и ZwRecoverTransactionManager являются двумя версиями одной подпрограммы системных служб Windows Native.
Для вызовов драйверов в режиме ядра NtXxx и ZwXxx версии подпрограммы Windows Native System Services могут вести себя по-разному в том, как они обрабатывают и интерпретируют входные параметры. Дополнительные сведения о связи между NtXxx и ZwXxx версиями подпрограммы см. в разделе Using Nt and Zw Versions of the Native System Services Routines.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Доступно в Windows Vista и более поздних версиях операционной системы. |
| целевая платформа | Всеобщий |
| заголовка | wdm.h (include Wdm.h, Ntifs.h) |
| библиотеки | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| правил соответствия DDI | HwStorPortProhibitedDDIs, PowerIrpDDis |
См. также
использование версий собственных системных служб и Zw