TmPrepareComplete-Funktion (wdm.h)
Die TmPrepareComplete-Routine benachrichtigt KTM, dass der aufrufende Ressourcen-Manager die Vorbereitung der Daten einer Transaktion abgeschlossen hat.
Syntax
NTSTATUS TmPrepareComplete(
[in] PKENLISTMENT Enlistment,
[in] PLARGE_INTEGER TmVirtualClock
);
Parameter
[in] Enlistment
Ein Zeiger auf ein Eintragsobjekt. Ihre Komponente kann diesen Zeiger als Eingabe für 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 virtuellen Uhrwert. Dieser Parameter ist optional und kann NULL sein.
Rückgabewert
TmPrepareComplete 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 |
|---|---|
|
Die Transaktion oder ihre Einlistung befindet sich nicht im richtigen Zustand. Beispielsweise hat KTM keine TRANSACTION_NOTIFY_PREPREPARE Benachrichtigung gesendet. |
Die Routine gibt möglicherweise andere NTSTATUS-Werte zurück.
Hinweise
Die TmPrepareComplete-Routine ist eine zeigerbasierte Version der ZwPrepareComplete-Routine .
Informationen dazu, wann die TmXxx-Routinen von KTM anstelle von ZwXxx-Routinen verwendet werden sollen, finden Sie unter Verwenden von TmXxx-Routinen.
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 |