tmPrepareEnlistment 函式 (wdm.h)

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

語法

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

[in] Enlistment

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

[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