Fungsi NtSetInformationTransaction (wdm.h)

Artikel
08/08/2023

Rutinitas ZwSetInformationTransaction menetapkan informasi untuk transaksi tertentu.

Sintaks

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

Parameter

[in] TransactionHandle

Handel ke objek transaksi yang diperoleh oleh panggilan sebelumnya ke ZwCreateTransaction atau ZwOpenTransaction. Handel harus memiliki akses TRANSACTION_SET_INFORMATION ke objek .

[in] TransactionInformationClass

Nilai berjenis TRANSACTION_INFORMATION_CLASS yang menentukan jenis informasi yang akan diatur. Nilainya harus TransactionPropertiesInformation.

[in] TransactionInformation

Penunjuk ke buffer yang dialokasikan penelepon yang berisi informasi yang akan diatur. Jenis struktur buffer harus TRANSACTION_PROPERTIES_INFORMATION.

[in] TransactionInformationLength

Panjangnya, dalam byte, dari buffer yang dirujuk parameter TransactionInformation .

Nilai kembali

ZwSetInformationTransaction mengembalikan STATUS_SUCCESS jika operasi berhasil. Jika tidak, rutinitas ini mungkin mengembalikan salah satu nilai berikut:

Menampilkan kode	Deskripsi
STATUS_INVALID_INFO_CLASS	Nilai parameter TransactionInformationClass tidak valid.
STATUS_OBJECT_TYPE_MISMATCH	Handel yang ditentukan parameter TransactionHandle bukan handel untuk objek transaksi.
STATUS_INVALID_HANDLE	Handel objek tidak valid.
STATUS_ACCESS_DENIED	Pemanggil tidak memiliki akses yang sesuai ke objek transaksi.
STATUS_INFO_LENGTH_MISMATCH	Nilai parameter TransactionInformationLength tidak valid.
STATUS_INVALID_PARAMETER	Isi buffer yang ditentukan buffer TransactionInformation tidak valid.

Rutinitas mungkin mengembalikan nilai NTSTATUS lainnya.

Keterangan

Untuk informasi selengkapnya tentang ZwSetInformationTransaction, lihat Membuat Klien Transaksional.

NtSetInformationTransaction dan ZwSetInformationTransaction adalah dua versi dari rutinitas Windows Native System Services yang sama.

Untuk panggilan dari driver mode kernel, versi NtXxx dan ZwXxx dari rutinItas Windows Native System Services dapat berperilaku berbeda dalam cara mereka menangani dan menginterpretasikan parameter input. Untuk informasi selengkapnya tentang hubungan antara versi NtXxx dan ZwXxx dari rutinitas, lihat Menggunakan Versi Nt dan Zw dari Rutinitas Layanan Sistem Asli.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia di Windows Vista dan versi sistem operasi yang lebih baru.
Target Platform	Universal
Header	wdm.h (termasuk Wdm.h, Ntddk.h, Ntifs.h)
Pustaka	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
Aturan kepatuhan DDI	HwStorPortProhibitedDDIs, PowerIrpDDis