Funzione TmDereferenceEnlistmentKey (wdm.h)
La routine TmDereferenceEnlistmentKey decrementa il conteggio dei riferimenti per la chiave di un oggetto di integrazione specificato.
Sintassi
NTSTATUS TmDereferenceEnlistmentKey(
[in] PKENLISTMENT Enlistment,
[out, optional] PBOOLEAN LastReference
);
Parametri
[in] Enlistment
Puntatore a un oggetto di integrazione. Il componente può ricevere questo puntatore come input a una routine di callback ResourceManagerNotification . In alternativa, il componente può chiamare ObReferenceObjectByHandle e fornire l'handle dell'oggetto fornito da una chiamata precedente a ZwCreateEnlistment, TmCreateEnlistment o ZwOpenEnlistment .
[out, optional] LastReference
Puntatore a una variabile tipizzata BOOLEAN. Questa variabile riceve TRUE se il conteggio dei riferimenti è zero dopo tmDereferenceEnlistmentKey lo decrementa. In caso contrario, la variabile riceve FALSE.
Valore restituito
TmDereferenceEnlistmentKey restituisce STATUS_SUCCESS se l'operazione ha esito positivo. In caso contrario, questa routine potrebbe restituire uno dei valori seguenti:
| Codice restituito | Descrizione |
|---|---|
|
Il numero di riferimenti dell'oggetto di integrazione specificato è zero e non può essere decrementato. |
La routine potrebbe restituire altri valori NTSTATUS.
Commenti
La routine TmReferenceEnlistmentKey incrementa il conteggio dei riferimenti per la chiave di un oggetto di integrazione e la routine TmDereferenceEnlistmentKey decrementa il conteggio.
Per informazioni su quando usare le routine TmXxx di KTM anziché le routine ZwXxx , vedere Using TmXxx Routines (Uso delle routine TmXxx).
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile in Windows Vista e versioni successive del sistema operativo. |
| Piattaforma di destinazione | Universale |
| Intestazione | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| Libreria | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= DISPATCH_LEVEL |