Fonction TmDereferenceEnlistmentKey (wdm.h)
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 |
|---|---|
|
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 |