TmPrePrepareComplete-Funktion (wdm.h)

Die TmPrePrepareComplete-Routine benachrichtigt KTM, dass der aufrufende Ressourcen-Manager die Vorbereitung der Daten einer Transaktion abgeschlossen hat.

Syntax

NTSTATUS TmPrePrepareComplete(
  [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

TmPrePrepareComplete 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_TRANSACTION_NOT_REQUESTED
Die Transaktion oder ihre Einlistung befindet sich nicht im richtigen Zustand. BEISPIELSWEISE hat KTM keine TRANSACTION_NOTIFY_PREPARE Benachrichtigung gesendet.
 

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

Hinweise

Die TmPrePrepareComplete-Routine ist eine zeigerbasierte Version der ZwPrePrepareComplete-Routine .

Informationen zur Verwendung der TMXxx-Routinen von KTM anstelle von ZwXxx-Routinen 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

Weitere Informationen

ObReferenceObjectByHandle

ResourceManagerNotification

TmCreateEnlistment

ZwCreateEnlistment

ZwOpenEnlistment

ZwPrePrePareComplete