NtQueryInformationTransactionManager-Funktion (wdm.h)
Die ZwQueryInformationTransactionManager Routine ruft Informationen zu einem angegebenen Transaktions-Manager-Objekt ab.
Syntax
__kernel_entry NTSYSCALLAPI NTSTATUS NtQueryInformationTransactionManager(
[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 ZwOpenTransactionManagerabgerufen wurde. Das Handle muss über TRANSACTIONMANAGER_QUERY_INFORMATION Zugriff auf das Objekt verfügen.
[in] TransactionManagerInformationClass
Ein TRANSACTIONMANAGER_INFORMATION_CLASS-typed-Enumerationswert, der die zu erhaltenden Informationen angibt. Dieser Wert muss eine der folgenden Werte sein:
- TransactionManagerBasicInformation
- TransactionManagerLogInformation-
- TransactionManagerLogPathInformation-
[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_INFORMATIONoder TRANSACTIONMANAGER_RECOVERY_INFORMATIONsein.
[in] TransactionManagerInformationLength
Die Länge des Puffers, auf den der TransactionManagerInformation Parameter verweist, einschließlich der Länge aller zusätzlichen Arrayelemente, die der Aufrufer zum Empfangen von Informationen zugewiesen hat.
[out, optional] ReturnLength
Ein Zeiger auf eine vom Aufrufer zugewiesene Variable, die die Länge (in Byte) der Informationen empfängt, die KTM in den TransactionManagerInformation- Puffer schreibt. Dieser Parameter ist optional und kann NULL-werden.
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 |
---|---|
|
Der Wert des TransactionManagerInformationClass- Parameters ist ungültig. |
|
Die Länge des Puffers, der vom TransactionManagerInformationLength Parameter angegeben wird, ist falsch. |
|
Das angegebene Handle ist kein Handle für ein Transaktions-Manager-Objekt. |
|
Ein Objekthandle ist ungültig. |
|
Der Aufrufer hat keinen geeigneten Zugriff auf das Transaktions-Manager-Objekt. |
|
Der vom TransactionManagerInformation Parameter angegebene Puffer ist zu klein. |
Die Routine gibt möglicherweise andere NTSTATUS-Wertezurück.
Bemerkungen
Weitere Informationen zur Verwendung von ZwQueryInformationTransactionManagerfinden Sie unter Verwenden von Log Streams 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, wie sie Eingabeparameter behandeln und interpretieren. Weitere Informationen zur Beziehung zwischen den NtXxx und ZwXxx- Versionen einer Routine finden Sie unter Using Nt and Zw Versions of the Native System Services Routines.
Anforderungen
Anforderung | Wert |
---|---|
mindestens unterstützte Client- | Verfügbar in Windows Vista und höheren Betriebssystemversionen. |
Zielplattform- | Universal |
Header- | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
Library | NtosKrnl.lib |
DLL- | NtosKrnl.exe |
IRQL- | PASSIVE_LEVEL |
DDI-Complianceregeln | HwStorPortProhibitedDIs, PowerIrpDDis |
Siehe auch
TRANSACTIONMANAGER_BASIC_INFORMATION
TRANSACTIONMANAGER_INFORMATION_CLASS
TRANSACTIONMANAGER_LOGPATH_INFORMATION
TRANSACTIONMANAGER_LOG_INFORMATION
Verwenden von Nt- und Zw-Versionen der systemeigenen Systemdienste-Routinen