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

Статья
02/27/2024

Подпрограмма 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