NtPrePrepareEnlistment-Funktion (wdm.h)
Die ZwPrePrepareEnlistment-Routine initiiert den Vorvorbereitungsvorgang für die Transaktion eines angegebenen Eintrags.
Syntax
__kernel_entry NTSYSCALLAPI NTSTATUS NtPrePrepareEnlistment(
[in] HANDLE EnlistmentHandle,
[in, optional] PLARGE_INTEGER TmVirtualClock
);
Parameter
[in] EnlistmentHandle
Ein Handle für ein Enlistment-Objekt , das durch einen vorherigen Aufruf von ZwCreateEnlistment oder ZwOpenEnlistment abgerufen wurde. Das -Objekt muss eine übergeordnete Auflistung darstellen, und das Handle muss ENLISTMENT_SUPERIOR_RIGHTS Zugriff auf das Objekt haben.
[in, optional] TmVirtualClock
Ein Zeiger auf einen wert der virtuellen Uhr. Dieser Parameter ist optional und kann NULL sein.
Rückgabewert
ZwPrePrePareEnlistment 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 |
|---|---|
|
Der Aufrufer ist kein überlegener Transaktions-Manager für die Aufnahme. |
|
Der Anrufer hat sich nicht registriert, um TRANSACTION_NOTIFY_PREPREPARE_COMPLETE Benachrichtigungen zu erhalten. |
|
Das angegebene Handle ist kein Handle für ein Einlistungsobjekt. |
|
Das Objekthandle ist ungültig. |
|
Der Aufrufer hat keinen entsprechenden Zugriff auf das Einlistungsobjekt. |
|
Die Transaktion der Einlistung befindet sich nicht in einem Zustand, der es ihr ermöglicht, in die Vorbereitungsphase zu gelangen. |
Die Routine gibt möglicherweise andere NTSTATUS-Werte zurück.
Hinweise
Nur überlegene Transaktionsmanager können ZwPrePrePrepareEnlistment aufrufen.
Anrufer von ZwPrePrePareEnlistment müssen sich registrieren, um TRANSACTION_NOTIFY_PREPREPARE_COMPLETE Benachrichtigungen zu erhalten.
Die ZwPrePrepareEnlistment-Routine bewirkt, dass KTM TRANSACTION_NOTIFY_PREPREPARE Benachrichtigungen an alle Ressourcenmanager sendet, die sich für die Transaktion angemeldet haben.
Weitere Informationen zu ZwPrePrepareEnlistment finden Sie unter Erstellen eines übergeordneten Transaktions-Managers und Behandeln von Commitvorgängen.
NtPrepareEnlistment und ZwPrepareEnlistment 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, da 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 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 |