Freigeben über


NtSetInformationTransaction-Funktion (wdm.h)

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

Weitere Informationen

TRANSACTION_INFORMATION_CLASS

TRANSACTION_PROPERTIES_INFORMATION

Verwenden von Nt- und Zw-Versionen der Systemdienstroutinen

ZwCreateTransaction

ZwOpenTransaction

ZwQueryInformationTransaction