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


Функция 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 System Services.

Для вызовов драйверов в режиме ядра 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

См. также

TmRecoverResourceManager

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

ZwCreateResourceManager

ZwOpenResourceManager

ZwQueryInformationResourceManager

ZwSetInformationResourceManager