tmCommitTransaction 函式 (wdm.h)

TmCommitTransaction 例程會起始指定交易的認可作業。

語法

NTSTATUS TmCommitTransaction(
  [in] PKTRANSACTION Transaction,
  [in] BOOLEAN       Wait
);

[in] Transaction

交易物件的指標。若要取得此指標，您的 TPS 元件必須呼叫 ObReferenceObjectByHandle ，並提供先前呼叫 ZwCreateTransaction 或 ZwOpenTransaction 的物件句柄。

[in] Wait

呼叫端針對同步作業設定為 TRUE 的布爾值，或異步操作的 FALSE 。如果此參數為 TRUE，呼叫會在認可作業完成之後傳回。

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

傳回碼	Description
STATUS_TRANSACTION_SUPERIOR_EXISTS	呼叫端無法認可交易，因為有較佳的交易管理員存在。
STATUS_TRANSACTION_ALREADY_ABORTED	無法認可交易，因為它已回復。
STATUS_TRANSACTION_ALREADY_COMMITTED	交易已經認可。
STATUS_TRANSACTION_REQUEST_NOT_VALID	此交易的認可作業已經啟動。
STATUS_PENDING	認可通知已排入資源管理員佇列，而呼叫端已為 Wait 參數指定 FALSE。

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

TmCommitTransaction 例程是以指標為基礎的 ZwCommitTransaction 例程版本。

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

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