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


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

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

Синтаксис

__kernel_entry NTSYSCALLAPI NTSTATUS NtRecoverResourceManager(
  [in] HANDLE ResourceManagerHandle
);

Параметры

[in] ResourceManagerHandle

Дескриптор объекта resource manager, полученного при предыдущем вызове ZwCreateResourceManager или ZwOpenResourceManager. Дескриптор должен иметь RESOURCEMANAGER_RECOVER доступ к объекту .

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

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

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

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

Комментарии

Когда диспетчер ресурсов вызывает ZwRecoverResourceManager, KTM отправляет диспетчеру ресурсов уведомление TRANSACTION_NOTIFY_RECOVER для каждого из зачислений диспетчера ресурсов. (Если зачисление является высшим зачислением, KTM отправляет TRANSACTION_NOTIFY_RECOVER_QUERY вместо TRANSACTION_NOTIFY_RECOVER.)

Последнее уведомление, которое KTM отправляет диспетчеру ресурсов, TRANSACTION_NOTIFY_LAST_RECOVER.

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

NtRecoverResourceManager и ZwRecoverResourceManager — это две версии одной и той же подпрограммы системных служб Windows Native.

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

Требования

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

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

TmRecoverResourceManager

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

ZwCreateResourceManager

ZwOpenResourceManager

ZwQueryInformationResourceManager

ZwSetInformationResourceManager