ntSetInformationTransaction 函式 (wdm.h)

發行項
03/05/2024

ZwSetInformationTransaction 例程會設定指定交易的資訊。

語法

__kernel_entry NTSYSCALLAPI NTSTATUS NtSetInformationTransaction(
  [in] HANDLE                        TransactionHandle,
  [in] TRANSACTION_INFORMATION_CLASS TransactionInformationClass,
  [in] PVOID                         TransactionInformation,
  [in] ULONG                         TransactionInformationLength
);

參數

[in] TransactionHandle

先前呼叫 ZwCreateTransaction 或 ZwOpenTransaction 所取得之交易物件的句柄。句柄必須具有物件的TRANSACTION_SET_INFORMATION存取權。

[in] TransactionInformationClass

TRANSACTION_INFORMATION_CLASS型別值，指定要設定的信息類型。此值必須是 TransactionPropertiesInformation。

[in] TransactionInformation

呼叫端配置的緩衝區指標，其中包含要設定的資訊。緩衝區的結構類型必須 TRANSACTION_PROPERTIES_INFORMATION。

[in] TransactionInformationLength

TransactionInformation 參數所指向之緩衝區的長度，以位元組為單位。

傳回值

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

傳回碼	Description
STATUS_INVALID_INFO_CLASS	TransactionInformationClass 參數的值無效。
STATUS_OBJECT_TYPE_MISMATCH	TransactionHandle 參數指定的句柄不是交易物件的句柄。
STATUS_INVALID_HANDLE	物件句柄無效。
STATUS_ACCESS_DENIED	呼叫端沒有交易對象的適當存取權。
STATUS_INFO_LENGTH_MISMATCH	TransactionInformationLength 參數的值無效。
STATUS_INVALID_PARAMETER	TransactionInformation 緩衝區指定的緩衝區內容無效。

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

備註

如需 ZwSetInformationTransaction 的詳細資訊，請參閱建立交易式用戶端。

NtSetInformationTransaction 和 ZwSetInformationTransaction 是相同 Windows Native System Services 例程的兩個版本。

針對來自內核模式驅動程式的呼叫，Windows 原生系統服務例程的 NtXxx 和 ZwXxx 版本會以處理和解譯輸入參數的方式，以不同的方式運作。如需 例程 NtXxx 和 ZwXxx 版本之間關聯性的詳細資訊，請參閱使用原生系統服務例程的 Nt 和 Zw 版本。

規格需求

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