TmReadOnlyEnlistment-Funktion (wdm.h)

Artikel
02/27/2024

Die TmReadOnlyEnlistment-Routine legt eine angegebene Eintrag als schreibgeschützt fest.

Syntax

NTSTATUS TmReadOnlyEnlistment(
  [in] PKENLISTMENT   Enlistment,
  [in] PLARGE_INTEGER TmVirtualClock
);

Parameter

[in] Enlistment

Ein Zeiger auf ein Eintragsobjekt. Ihre Komponente kann diesen Zeiger als Eingabe für 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 virtuellen Uhrwert. Dieser Parameter ist optional und kann NULL sein.

Rückgabewert

TmReadOnlyEnlistment 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 kann ein Eintrag nicht schreibgeschützt sein, wenn das flag ENLISTMENT_SUPERIOR für ZwCreateEnlistment angegeben wurde.

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

Hinweise

Die TmReadOnlyEnlistment-Routine ist eine zeigerbasierte Version der ZwReadOnlyEnlistment-Routine .

Informationen dazu, wann die TmXxx-Routinen von KTM anstelle von ZwXxx-Routinen verwendet werden sollen, 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