TmRecoverEnlistment-Funktion (wdm.h)

Artikel
02/29/2024

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
STATUS_OBJECT_TYPE_MISMATCH	Das angegebene Handle ist kein Handle für ein Einlistungsobjekt.
STATUS_INVALID_HANDLE	Ein Objekthandle ist ungültig.
STATUS_TRANSACTION_REQUEST_NOT_VALID	Die Transaktion oder ihre Einlistung befindet sich nicht im richtigen Zustand.
STATUS_PENDING	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