TmRequestOutcomeEnlistment-Funktion (wdm.h)
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 |
|---|---|
|
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 |