NtRecoverTransactionManager-Funktion (wdm.h)
Die ZwRecoverTransactionManager-Routine rekonstruiert den Status des Transaktions-Manager-Objekts (einschließlich aller Transaktionen, Listen und Ressourcen-Manager) aus den Wiederherstellungsinformationen, die sich im Protokolldatenstrom befinden.
Syntax
__kernel_entry NTSYSCALLAPI NTSTATUS NtRecoverTransactionManager(
[in] HANDLE TransactionManagerHandle
);
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 über TRANSACTIONMANAGER_RECOVER Zugriff auf das Objekt verfügen.
Rückgabewert
ZwRecoverTransactionManager 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 |
|---|---|
|
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. |
|
Das Transaktions-Manager-Objekt ist veränderlich, sodass seine Transaktionen nicht wiederhergestellt werden können. |
|
Das Transaktions-Manager-Objekt befindet sich nicht in einem Zustand, der die Wiederherstellung zulässt. |
Die Routine gibt möglicherweise andere NTSTATUS-Werte zurück.
Hinweise
Die ZwRecoverTransactionManager-Routine versucht, den Status des Transaktions-Manager-Objekts, einschließlich aller Transaktionen, Listen und Ressourcen-Manager, aus den Wiederherstellungsinformationen im Protokolldatenstrom des Objekts zu rekonstruieren, beginnend beim letzten Neustartbereich , den KTM erstellt hat, und endet am Ende des Datenstroms.
Um bis zu einer bestimmten virtuellen Zeit wiederherzustellen, verwenden Sie die Routine ZwRollforwardTransactionManager anstelle von ZwRecoverTransactionManager.
Ihre TPS-Komponente muss ZwRecoverTransactionManager aufrufen, nachdem sie ZwCreateTransactionManager oder ZwOpenTransactionManager aufgerufen hat.
Weitere Informationen zu Wiederherstellungsvorgängen finden Sie unter Behandeln von Wiederherstellungsvorgängen.
NtRecoverTransactionManager und ZwRecoverTransactionManager 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 (include Wdm.h, Ntifs.h) |
| Bibliothek | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| DDI-Complianceregeln | HwStorPortProhibitedDIs, PowerIrpDDis |