共用方式為


tmPrepareEnlistment 函式 (wdm.h)

TmPrePrepareEnlistment 例程會起始指定登記交易的預先準備作業。

語法

NTSTATUS TmPrePrepareEnlistment(
  [in] PKENLISTMENT   Enlistment,
  [in] PLARGE_INTEGER TmVirtualClock
);

參數

[in] Enlistment

登記物件的指標。 您的元件可以接收此指標作為 ResourceManagerNotification 回呼例程的輸入。 或者,您的元件可以呼叫 ObReferenceObjectByHandle ,並提供先前呼叫 ZwCreateEnlistmentTmCreateEnlistmentZwOpenEnlistment 的物件句柄。

[in] TmVirtualClock

虛擬時鐘值的指標。 此參數是選擇性的,可以是 NULL

傳回值

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

傳回碼 Description
STATUS_ENLISTMENT_NOT_SUPERIOR
呼叫端不是登記的 上層交易管理員
STATUS_TRANSACTION_RESPONSE_NOT_ENLISTED
呼叫端未註冊以接收TRANSACTION_NOTIFY_PREPREPARE_COMPLETE通知。
STATUS_TRANSACTION_REQUEST_NOT_VALID
交易的狀態不允許它進入準備前階段。
STATUS_ACCESS_DENIED
呼叫端對登記對象沒有適當的存取權。
 

例程可能會傳回其他 NTSTATUS值

備註

TmPrePrepareEnlistment 例程是以指標為基礎的 ZwPrepareEnlistment 例程版本。

只有進階交易管理員可以呼叫 TmPrepareEnlistment

如需何時使用 KTM 的 TmXxx 例程,而不是 ZwXxx 例程的相關信息,請參閱 使用 TmXxx 例程

規格需求

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

另請參閱

ObReferenceObjectByHandle

ResourceManagerNotification

TmCreateEnlistment

ZwCreateEnlistment

ZwOpenEnlistment

ZwPrepareEnlistment