Freigeben über

ZwQueryInformationTransactionManager-Funktion (wdm.h)

Die ZwQueryInformationTransactionManager-Routine ruft Informationen zu einem angegebenen Transaktions-Manager-Objekt ab.

Syntax

NTSYSCALLAPI NTSTATUS ZwQueryInformationTransactionManager(
  [in]            HANDLE                               TransactionManagerHandle,
  [in]            TRANSACTIONMANAGER_INFORMATION_CLASS TransactionManagerInformationClass,
  [out]           PVOID                                TransactionManagerInformation,
  [in]            ULONG                                TransactionManagerInformationLength,
  [out, optional] PULONG                               ReturnLength
);

Parameter

[in] TransactionManagerHandle

Ein Handle für ein Transaktions-Manager-Objekt , das durch einen vorherigen Aufruf von ZwCreateTransactionManager oder ZwOpenTransactionManager abgerufen wurde. Das Handle muss TRANSACTIONMANAGER_QUERY_INFORMATION Zugriff auf das Objekt haben.

[in] TransactionManagerInformationClass

Ein TRANSACTIONMANAGER_INFORMATION_CLASS typisierter Enumerationswert, der die zu erhaltenden Informationen angibt. Dieser Wert muss einer der folgenden Werte sein:

  • TransactionManagerBasicInformation
  • TransactionManagerLogInformation
  • TransactionManagerLogPathInformation
Der TransactionManagerOnlineProbeInformation-Wert der Enumeration wird nicht mit ZwQueryInformationTransactionManager verwendet.

[out] TransactionManagerInformation

Ein Zeiger auf einen vom Aufrufer zugewiesenen Puffer, der die Informationen empfängt, die der TransactionManagerInformationClass-Parameter angibt. Der Strukturtyp des Puffers muss TRANSACTIONMANAGER_BASIC_INFORMATION, TRANSACTIONMANAGER_LOG_INFORMATION, TRANSACTIONMANAGER_LOGPATH_INFORMATION oder TRANSACTIONMANAGER_RECOVERY_INFORMATION sein.

[in] TransactionManagerInformationLength

Die Länge des Puffers in Bytes, auf den der TransactionManagerInformation-Parameter verweist, einschließlich der Länge aller zusätzlichen Arrayelemente, die der Aufrufer für den Empfang von Informationen zugewiesen hat.

[out, optional] ReturnLength

Ein Zeiger auf eine vom Aufrufer zugewiesene Variable, die die Länge (in Bytes) der Informationen empfängt, die KTM in den TransactionManagerInformation-Puffer schreibt. Dieser Parameter ist optional und kann NULL sein.

Rückgabewert

ZwQueryInformationTransactionManager 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 Parameters TransactionManagerInformationClass ist ungültig.
STATUS_INFO_LENGTH_MISMATCH
 Die Länge des Puffers, der durch den Parameter TransactionManagerInformationLength angegeben wird, ist falsch.
STATUS_OBJECT_TYPE_MISMATCH
 Das angegebene Handle ist kein Handle für ein Transaktions-Manager-Objekt.
STATUS_INVALID_HANDLE
 Ein Objekthandle ist ungültig.
STATUS_ACCESS_DENIED
 Der Aufrufer hat keinen entsprechenden Zugriff auf das Transaktions-Manager-Objekt.
STATUS_BUFFER_TOO_SMALL
 Der Puffer, der durch den Parameter TransactionManagerInformation angegeben wird, ist zu klein.
 

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

Hinweise

Weitere Informationen zur Verwendung von ZwQueryInformationTransactionManager finden Sie unter Verwenden von Protokollstreams mit KTM.

NtQueryInformationTransactionManager und ZwQueryInformationTransactionManager 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, da 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 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 HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm)

Weitere Informationen

TRANSACTIONMANAGER_BASIC_INFORMATION

TRANSACTIONMANAGER_INFORMATION_CLASS

TRANSACTIONMANAGER_LOGPATH_INFORMATION

TRANSACTIONMANAGER_LOG_INFORMATION

Verwenden von Nt- und Zw-Versionen der Systemdienstroutinen

ZwCreateTransactionManager

ZwOpenTransactionManager

ZwRecoverTransactionManager

ZwRollforwardTransactionManager

  • Last updated on