Fonction TmDereferenceEnlistmentKey (wdm.h)

Article
02/27/2024

La routine TmDereferenceEnlistmentKey décrémente le nombre de références pour la clé d’un objet d’inscription spécifié.

Syntaxe

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

Paramètres

[in] Enlistment

Pointeur vers un objet d’inscription. Votre composant peut recevoir ce pointeur en tant qu’entrée dans une routine de rappel ResourceManagerNotification . Votre composant peut également appeler ObReferenceObjectByHandle et fournir le handle d’objet fourni par un appel précédent à ZwCreateEnlistment, TmCreateEnlistment ou ZwOpenEnlistment .

[out, optional] LastReference

Pointeur vers une variable de type BOOLEAN. Cette variable reçoit TRUE si le nombre de références est égal à zéro après que TmDereferenceEnlistmentKey l’a décrémenté. Sinon, la variable reçoit FALSE.

Valeur retournée

TmDereferenceEnlistmentKey retourne STATUS_SUCCESS si l’opération réussit. Sinon, cette routine peut retourner l’une des valeurs suivantes :

Code de retour	Description
STATUS_UNSUCCESSFUL	Le nombre de références de l’objet d’inscription spécifié est égal à zéro et ne peut pas être décrémenté.

La routine peut retourner d’autres valeurs NTSTATUS.

Remarques

La routine TmReferenceEnlistmentKey incrémente le nombre de références pour la clé d’un objet d’inscription, et la routine TmDereferenceEnlistmentKey décrémente le nombre.

Pour plus d’informations sur l’utilisation des routines TmXxx de KTM au lieu des routines ZwXxx , consultez Utilisation des routines TmXxx.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible dans Windows Vista et les versions ultérieures du système d’exploitation.
Plateforme cible	Universal
En-tête	wdm.h (inclure Wdm.h, Ntddk.h, Ntifs.h)
Bibliothèque	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= DISPATCH_LEVEL