TmDereferenceEnlistmentKey-Funktion (wdm.h)

Artikel
02/27/2024

Die TmDereferenceEnlistmentKey-Routine verringert die Verweisanzahl für den Schlüssel eines angegebenen Eintragsobjekts.

Syntax

NTSTATUS TmDereferenceEnlistmentKey(
  [in]            PKENLISTMENT Enlistment,
  [out, optional] PBOOLEAN     LastReference
);

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.

[out, optional] LastReference

Ein Zeiger auf eine VARIABLE vom Typ BOOLEAN. Diese Variable empfängt TRUE , wenn die Verweisanzahl null ist, nachdem tmDereferenceEnlistmentKey sie erhöht hat. Andernfalls empfängt die Variable FALSE.

Rückgabewert

TmDereferenceEnlistmentKey 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_UNSUCCESSFUL	Die Verweisanzahl des angegebenen Eintragsobjekts ist null und kann nicht dekrementiert werden.

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

Hinweise

Die TmReferenceEnlistmentKey-Routine erhöht die Verweisanzahl für den Schlüssel eines Eintragsobjekts, und die TmDereferenceEnlistmentKey-Routine verringert die Anzahl.

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	<= DISPATCH_LEVEL