ZwRecoverResourceManager 函式 (wdm.h)

發行項
03/01/2024

ZwRecoverResourceManager 例程會嘗試復原與指定資源管理員物件每個登記相關聯的交易。

語法

NTSYSCALLAPI NTSTATUS ZwRecoverResourceManager(
  [in] HANDLE ResourceManagerHandle
);

參數

[in] ResourceManagerHandle

由先前呼叫 ZwCreateResourceManager 或 ZwOpenResourceManager 取得的資源管理員物件的句柄。句柄必須具有物件的RESOURCEMANAGER_RECOVER存取權。

傳回值

如果作業成功，ZwRecoverResourceManager 會傳回STATUS_SUCCESS。否則，此例程可能會傳回下列其中一個值：

傳回碼	Description
STATUS_OBJECT_TYPE_MISMATCH	指定的句柄不是 Resource Manager 物件的句柄。
STATUS_INVALID_HANDLE	物件句柄無效。
STATUS_TRANSACTIONMANAGER_NOT_ONLINE	與指定之資源管理員相關聯的交易管理員無法使用。
STATUS_ACCESS_DENIED	呼叫端沒有資源管理員對象的適當存取權。

例程可能會傳回其他 NTSTATUS值。

備註

當資源管理員呼叫 ZwRecoverResourceManager 時，KTM 會針對每個資源管理員的登記，將TRANSACTION_NOTIFY_RECOVER通知傳送給資源管理員。 (如果登記是進階登記，KTM 會傳送TRANSACTION_NOTIFY_RECOVER_QUERY，而不是 TRANSACTION_NOTIFY_RECOVER.)

KTM 傳送給資源管理員的最終通知是TRANSACTION_NOTIFY_LAST_RECOVER。

如需 ZwRecoverResourceManager 的詳細資訊，請參閱處理復原作業。

NtRecoverResourceManager 和 ZwRecoverResourceManager 是相同 Windows 原生系統服務例程的兩個版本。

對於核心模式驅動程式的呼叫，Windows 原生系統服務例程的 NtXxx 和 ZwXxx 版本在處理和解譯輸入參數的方式可能會有不同的行為。如需例程 NtXxx 和 ZwXxx 版本之間的關聯性詳細資訊，請參閱使用 Nt 和 Zw 版本的原生系統服務例程。

規格需求

需求	值
最低支援的用戶端	適用於 Windows Vista 和更新版本的作業系統版本。
目標平台	Universal
標頭	wdm.h (包括 Wdm.h、Ntifs.h)
程式庫	NtosKrnl.lib
Dll	NtosKrnl.exe
IRQL	PASSIVE_LEVEL