CreateResourceManager 函式 (ktmw32.h)
建立新的資源管理員 (RM) 物件,並將 RM 與交易管理員 (TM) 產生關聯。
語法
HANDLE CreateResourceManager(
[in, optional] LPSECURITY_ATTRIBUTES lpResourceManagerAttributes,
[in] LPGUID ResourceManagerId,
[in, optional] DWORD CreateOptions,
[in] HANDLE TmHandle,
[in, optional] LPWSTR Description
);
參數
[in, optional] lpResourceManagerAttributes
包含資源管理員安全性屬性之 SECURITY_ATTRIBUTES 結構的指標。 指定 NULL 以取得預設屬性。
[in] ResourceManagerId
資源管理員 GUID 的指標。 這是必要參數,而且不得 NULL。
[in, optional] CreateOptions
新 RM 的任何選擇性屬性。
價值 | 意義 |
---|---|
|
表示 RM 是揮發性的,而且不會執行復原。 |
[in] TmHandle
TM 的句柄,將管理此 RM 的交易。
[in, optional] Description
此 RM 的描述。
傳回值
如果函式成功,傳回值就是 RM 的句柄。
如果函式失敗,傳回值會INVALID_HANDLE_VALUE。 若要取得擴充的錯誤資訊,請呼叫 getLastError 函式
下列清單會識別可能的錯誤碼:
言論
在呼叫此函式之後,您必須呼叫 RecoverResourceManager。
RM 是TM通知的端點,涉及 RM 已登記的交易。
RM 通常是持續性的,這表示在系統失敗之後,必須重新開啟它們才能執行特定作業。 您可以藉由呼叫 createResourceManager 函式和指定RESOURCE_MANAGER_VOLATILE,來建立動態或暫時性 RM。 揮發性 RM 不會執行復原作業,但需要交易的相關通知。
您可以在耐久TM上建立揮發性 RM,但無法在揮發性TM上建立耐久 RM。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | Windows Vista |
支援的最低伺服器 | Windows Server 2008 |
目標平臺 | 窗戶 |
標頭 | ktmw32.h |
連結庫 | Ktmw32.lib |
DLL | Ktmw32.dll |