Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Die TmRecoverEnlistment-Routine initiiert einen Wiederherstellungsvorgang für die Transaktion, die einer angegebenen Liste zugeordnet ist.
Syntax
NTSTATUS TmRecoverEnlistment(
[in] PKENLISTMENT Enlistment,
[in] PVOID EnlistmentKey
);
Parameter
[in] Enlistment
Ein Zeiger auf ein Einlistungsobjekt. Ihre Komponente kann diesen Zeiger als Eingabe auf eine ResourceManagerNotification-Rückrufroutine empfangen. Alternativ kann Ihre Komponente ObReferenceObjectByHandle aufrufen und das Objekthandle bereitstellen, das ein vorheriger Aufruf von ZwCreateEnlistment, TmCreateEnlistment oder ZwOpenEnlistment bereitgestellt hat.
[in] EnlistmentKey
Ein Zeiger auf den Enlistment-Schlüsselwert, den der Ressourcen-Manager zuvor als EnlistmentKey-Parameter auf ZwCreateEnlistment oder TmCreateEnlistment angegeben hat. Dieser Parameter ist optional und kann NULL sein, wenn der Ressourcen-Manager keinen Auflistungsschlüssel bereitgestellt hat, wenn er ZwCreateEnlistment oder TmCreateEnlistment aufgerufen hat.
Rückgabewert
TmRecoverEnlistment 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 Einlistungsobjekt. |
|
Ein Objekthandle ist ungültig. |
|
Die Transaktion oder ihre Einlistung befindet sich nicht im richtigen Zustand. |
|
KTM hat der Benachrichtigungswarteschlange des Ressourcenmanagers eine Commit-, Rollback- oder Zweifelsbenachrichtigung hinzugefügt, und der Ressourcen-Manager verwendet keine ResourceManagerNotification-Rückrufroutine . |
Die Routine gibt möglicherweise andere NTSTATUS-Werte zurück.
Hinweise
Die TmRecoverEnlistment-Routine ist eine zeigerbasierte Version der ZwRecoverEnlistment-Routine .
Informationen zur Verwendung der TMXxx-Routinen von KTM anstelle von ZwXxx-Routinen finden Sie unter Verwenden von TmXxx-Routinen.
Weitere Informationen zu Wiederherstellungsvorgängen finden Sie unter Behandeln von Wiederherstellungsvorgängen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Verfügbar in Windows Vista und späteren Windows-Versionen. |
| Zielplattform | Universell |
| Header | wdm.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h) |
| Bibliothek | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |