NtSetInformationTransaction-Funktion (wdm.h)

Artikel
08/08/2023

Die ZwSetInformationTransaction-Routine legt Informationen für eine angegebene Transaktion fest.

Syntax

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

Parameter

[in] TransactionHandle

Ein Handle für ein Transaktionsobjekt , das durch einen vorherigen Aufruf von ZwCreateTransaction oder ZwOpenTransaction abgerufen wurde. Das Handle muss über TRANSACTION_SET_INFORMATION Zugriff auf das Objekt verfügen.

[in] TransactionInformationClass

Ein TRANSACTION_INFORMATION_CLASS typisierter Wert, der den Typ der festzulegenden Informationen angibt. Der Wert muss TransactionPropertiesInformation sein.

[in] TransactionInformation

Ein Zeiger auf einen vom Aufrufer zugeordneten Puffer, der die festzulegenden Informationen enthält. Der Strukturtyp des Puffers muss TRANSACTION_PROPERTIES_INFORMATION sein.

[in] TransactionInformationLength

Die Länge des Puffers in Bytes, auf den der TransactionInformation-Parameter verweist.

Rückgabewert

ZwSetInformationTransaction gibt STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist. Andernfalls gibt diese Routine möglicherweise einen der folgenden Werte zurück:

Rückgabecode	Beschreibung
STATUS_INVALID_INFO_CLASS	Der Wert des TransactionInformationClass-Parameters ist ungültig.
STATUS_OBJECT_TYPE_MISMATCH	Das Handle, das der TransactionHandle-Parameter angibt, ist kein Handle für ein Transaktionsobjekt.
STATUS_INVALID_HANDLE	Ein Objekthandle ist ungültig.
STATUS_ACCESS_DENIED	Der Aufrufer hat keinen geeigneten Zugriff auf das Transaktionsobjekt.
STATUS_INFO_LENGTH_MISMATCH	Der Wert des TransactionInformationLength-Parameters ist ungültig.
STATUS_INVALID_PARAMETER	Der Inhalt des Puffers, den der TransactionInformation-Puffer angibt, ist ungültig.

Die Routine gibt möglicherweise andere NTSTATUS-Werte zurück.

Hinweise

Weitere Informationen zu ZwSetInformationTransaction finden Sie unter Erstellen eines Transaktionsclients.

NtSetInformationTransaction und ZwSetInformationTransaction sind zwei Versionen derselben Windows Native System Services-Routine.

Bei Aufrufen von Kernelmodustreibern können sich die NtXxx - und ZwXxx-Versionen einer Windows Native System Services-Routine anders verhalten, wie sie Eingabeparameter verarbeiten und interpretieren. Weitere Informationen zur Beziehung zwischen den Nt Xxx- und ZwXxx-Versionen einer Routine finden Sie unter Verwenden von Nt- und Zw-Versionen der systemeigenen Systemdienstroutinen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Windows Vista und höheren Betriebssystemversionen.
Zielplattform	Universell
Header	wdm.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h)
Bibliothek	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
DDI-Complianceregeln	HwStorPortProhibitedDIs, PowerIrpDDis