NtPrePrepareComplete-Funktion (wdm.h)

Die ZwPrePrepareComplete-Routine benachrichtigt KTM, dass der aufrufende Ressourcenmanager die vorläufige Vorbereitung der Daten einer Transaktion abgeschlossen hat.

Syntax

__kernel_entry NTSYSCALLAPI NTSTATUS NtPrePrepareComplete(
  [in]           HANDLE         EnlistmentHandle,
  [in, optional] PLARGE_INTEGER TmVirtualClock
);

Parameter

[in] EnlistmentHandle

Ein Handle für ein Eintragsobjekt , das durch einen vorherigen Aufruf von ZwCreateEnlistment oder ZwOpenEnlistment abgerufen wurde. Das Handle muss über ENLISTMENT_SUBORDINATE_RIGHTS Zugriff auf das Objekt verfügen.

[in, optional] TmVirtualClock

Ein Zeiger auf einen virtuellen Uhrwert. Dieser Parameter ist optional und kann NULL sein.

Rückgabewert

ZwPrePrepareComplete 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 Eintragsobjekt.
STATUS_INVALID_HANDLE
Das Objekthandle ist ungültig.
STATUS_TRANSACTION_NOT_REQUESTED
Die Transaktion oder ihre Einlistung befindet sich nicht im richtigen Zustand.
STATUS_ACCESS_DENIED
Der Aufrufer hat keinen geeigneten Zugriff auf das Eintragsobjekt.
 

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

Hinweise

Ein Ressourcen-Manager muss ZwPrePrepareComplete aufrufen, nachdem er die Wartung einer TRANSACTION_NOTIFY_PREPREPARE Benachrichtigung abgeschlossen hat.

Weitere Informationen zu ZwPrePrepareComplete finden Sie unter Behandeln von Commitvorgängen.

NtPrePrepareComplete und ZwPrePrepareComplete sind zwei Versionen derselben Windows Native System Services-Routine.

Bei Aufrufen von Kernelmodustreibern können sich die NtXxx - und ZwXxx-Versionen einer Windows Native System Services-Routine anders verhalten, wie sie Eingabeparameter verarbeiten und interpretieren. Weitere Informationen zur Beziehung zwischen den Nt Xxx- und ZwXxx-Versionen einer Routine finden Sie unter Verwenden von Nt- und Zw-Versionen der systemeigenen Systemdienstroutinen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Verfügbar in Windows Vista und höheren Betriebssystemversionen.
Zielplattform Universell
Header wdm.h (include Wdm.h, Ntifs.h)
Bibliothek NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
DDI-Complianceregeln HwStorPortProhibitedDIs, PowerIrpDDis

Weitere Informationen

TmPrePrepareComplete

Verwenden von Nt- und Zw-Versionen der Systemdienstroutinen

ZwCreateEnlistment

ZwOpenEnlistment

ZwPrepareComplete