TmRequestOutcomeEnlistment-Funktion (wdm.h)

Artikel
02/29/2024

Die TmRequestOutcomeEnlistment-Routine fordert KTM auf, ein sofortiges Ergebnis (Commit oder Rollback) für die Transaktion bereitzustellen, die einer angegebenen Registrierung zugeordnet ist.

Syntax

NTSTATUS TmRequestOutcomeEnlistment(
  [in] PKENLISTMENT   Enlistment,
  [in] PLARGE_INTEGER TmVirtualClock
);

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] TmVirtualClock

Ein Zeiger auf einen wert der virtuellen Uhr. Dieser Parameter ist optional und kann NULL sein.

Rückgabewert

TmRequestOutcomeEnlistment gibt STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist. Andernfalls gibt diese Routine möglicherweise den folgenden Wert zurück:

Rückgabecode	Beschreibung
STATUS_TRANSACTION_REQUEST_NOT_VALID	Die angegebene Einlistung ist eine übergeordnete Einlistung.

Die Routine gibt möglicherweise andere NTSTATUS-Werte zurück.

Hinweise

Die TmRequestOutcomeEnlistment-Routine fordert KTM auf, ein sofortiges Ergebnis (Ergebnis) für die Transaktion bereitzustellen. Ein Ressourcen-Manager kann TmRequestOutcomeEnlistment aufrufen, nachdem er TmPrepareComplete oder ZwPrepareComplete aufgerufen hat, wenn er später feststellt, dass er nicht auf ein Ergebnis warten kann, weil z. B. eine überraschende Entfernung des Datenträgers aufgetreten ist. KTM ist möglicherweise in der Lage, einen Rollback zu erzwingen, wenn alle Ressourcenmanager ihre Vorbereitungsvorgänge nicht abgeschlossen haben.

Informationen zur Verwendung der TMXxx-Routinen von KTM anstelle von ZwXxx-Routinen finden Sie unter Verwenden von TmXxx-Routinen.

Weitere Informationen zu TmCreateEnlistment finden Sie unter Erstellen eines Resource Manager.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Windows Vista und höheren Betriebssystemversionen.
Zielplattform	Universell
Header	wdm.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h)
Bibliothek	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL