ZwPrepareEnlistment-Funktion (wdm.h)

Die ZwPrepareEnlistment-Routine initiiert den Vorbereitungsvorgang für die Transaktion eines angegebenen Eintrags.

Syntax

NTSYSCALLAPI NTSTATUS ZwPrepareEnlistment(
  [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

ZwPrepareEnlistment 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_ENLISTMENT_NOT_SUPERIOR
Der Aufrufer ist kein überlegener Transaktions-Manager für die Aufnahme.
STATUS_TRANSACTION_RESPONSE_NOT_ENLISTED
Der Anrufer hat sich nicht registriert, um TRANSACTION_NOTIFY_PREPARE_COMPLETE Benachrichtigungen zu erhalten.
STATUS_OBJECT_TYPE_MISMATCH
Das angegebene Handle ist kein Handle für ein Einlistungsobjekt.
STATUS_INVALID_HANDLE
Das Objekthandle ist ungültig.
STATUS_ACCESS_DENIED
Der Aufrufer hat keinen entsprechenden Zugriff auf das Einlistungsobjekt.
STATUS_TRANSACTION_REQUEST_NOT_VALID
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 ZwPrepareEnlistment aufrufen.

Die ZwPrepareEnlistment-Routine bewirkt, dass KTM TRANSACTION_NOTIFY_PREPARE Benachrichtigungen an alle Ressourcenmanager sendet, die sich für die Transaktion angemeldet haben.

Anrufer von ZwPrepareEnlistment müssen sich registrieren, um TRANSACTION_NOTIFY_PREPARE_COMPLETE Benachrichtigungen zu erhalten.

Weitere Informationen zu ZwPrepareEnlistment finden Sie unter Erstellen eines übergeordneten Transaktions-Managers und Behandeln von Commitvorgängen.

NtPrePrepareEnlistment und ZwPrePrePareEnlistment 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 HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm)

Weitere Informationen

TmPrepareEnlistment

Verwenden von Nt- und Zw-Versionen der Systemdienstroutinen

ZwCreateEnlistment

ZwOpenEnlistment