ZwSinglePhaseReject-Funktion (wdm.h)

Die ZwSinglePhaseReject-Routine informiert KTM darüber, dass der aufrufende Ressourcen-Manager keine einphasigen Commitvorgänge für eine angegebene Liste unterstützt.

Syntax

NTSYSCALLAPI NTSTATUS ZwSinglePhaseReject(
  [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 Handle muss ENLISTMENT_SUBORDINATE_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

ZwSinglePhaseReject 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 Einlistungsobjekt.
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 entsprechenden Zugriff auf das Einlistungsobjekt.

 

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

Hinweise

Ein Ressourcen-Manager kann ZwSinglePhaseReject aufrufen, wenn er eine TRANSACTION_NOTIFY_SINGLE_PHASE_COMMIT Benachrichtigung empfängt.

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

NtSinglePhaseReject und ZwSinglePhaseReject sind zwei Versionen derselben Windows Native System Services-Routine. Die NtSinglePhaseReject-Routine im Windows-Kernel ist für Kernelmodustreiber nicht direkt zugänglich. Kernelmodustreiber können jedoch indirekt auf diese Routine zugreifen, indem sie die ZwSinglePhaseReject-Routine aufrufen.

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 (einschließlich Wdm.h, Ntddk.h, Ntifs.h)
Bibliothek	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
DDI-Complianceregeln	HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm)

Weitere Informationen

TmSinglePhaseReject

Verwenden von Nt- und Zw-Versionen der Systemdienstroutinen

ZwCreateEnlistment

ZwOpenEnlistment