ZwRecoverTransactionManager-Funktion (wdm.h)
Die ZwRecoverTransactionManager-Routine rekonstruiert den Zustand des Transaktions-Manager-Objekts (einschließlich aller Transaktionen, Einlistungen und Ressourcenmanager) aus den Wiederherstellungsinformationen, die sich im Protokolldatenstrom befinden.
Syntax
NTSYSCALLAPI NTSTATUS ZwRecoverTransactionManager(
[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 TRANSACTIONMANAGER_RECOVER Zugriff auf das Objekt haben.
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 entsprechenden Zugriff auf das Transaktions-Manager-Objekt. |
|
Das Transaktions-Manager-Objekt ist volatil, 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 Zustand des Transaktions-Manager-Objekts, einschließlich aller Transaktionen, Einlistungen und Ressourcenmanager, 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 ZwRollforwardTransactionManager-Routine 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, 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 (include Wdm.h, Ntifs.h) |
| Bibliothek | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| DDI-Complianceregeln | HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm) |