Fungsi FltRollbackEnlistment (fltkernel.h)

Artikel
08/07/2023

Rutinitas FltRollbackEnlistment menggulung balik atau membatalkan transaksi atas nama driver minifilter.

Sintaks

NTSTATUS FLTAPI FltRollbackEnlistment(
  [in]           PFLT_INSTANCE Instance,
  [in]           PKTRANSACTION Transaction,
  [in, optional] PFLT_CONTEXT  TransactionContext
);

Parameter

[in] Instance

Penunjuk instans buram untuk pemanggil.

[in] Transaction

Penunjuk transaksi buram untuk transaksi.

[in, optional] TransactionContext

Arahkan ke konteks transaksi driver minifilter.

Nilai kembali

FltRollbackEnlistment mengembalikan STATUS_SUCCESS atau nilai NTSTATUS yang sesuai, seperti salah satu hal berikut ini:

Menampilkan kode	Deskripsi
STATUS_NOT_FOUND	Driver minifilter tidak menetapkan konteks pada transaksi. Ini adalah kode kesalahan.
STATUS_TRANSACTION_REQUEST_NOT_VALID	Permintaan pembatalan transaksi tidak diizinkan untuk pendaftaran ini. Ini adalah kode kesalahan.

Keterangan

Driver minifilter yang terdaftar dalam transaksi dapat memanggil FltRollbackEnlistment untuk mengembalikan atau membatalkan transaksi.

Untuk mendaftar dalam transaksi, panggil FltEnlistInTransaction.

Untuk mengalokasikan konteks transaksi baru, panggil FltAllocateContext.

Untuk mengambil konteks transaksi, panggil FltGetTransactionContext.

Untuk menghapus konteks transaksi, panggil FltDeleteTransactionContext atau FltDeleteContext.

Untuk mengatur konteks transaksi, panggil FltSetTransactionContext.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Rutinitas ini tersedia pada Windows Vista dan yang lebih baru.
Target Platform	Universal
Header	fltkernel.h (termasuk Fltkernel.h)
Pustaka	FltMgr.lib
DLL	Fltmgr.sys
IRQL	<= APC_LEVEL