Función TmDereferenceEnlistmentKey (wdm.h)
La rutina TmDereferenceEnlistmentKey disminuye el recuento de referencias para la clave de un objeto de inscripción especificado.
Sintaxis
NTSTATUS TmDereferenceEnlistmentKey(
[in] PKENLISTMENT Enlistment,
[out, optional] PBOOLEAN LastReference
);
Parámetros
[in] Enlistment
Puntero a un objeto de inscripción. El componente puede recibir este puntero como entrada en una rutina de devolución de llamada ResourceManagerNotification . Como alternativa, el componente puede llamar a ObReferenceObjectByHandle y proporcionar el identificador del objeto que proporcionó una llamada anterior a ZwCreateEnlistment, TmCreateEnlistment o ZwOpenEnlistment proporcionada.
[out, optional] LastReference
Puntero a una variable con tipo BOOLEAN. Esta variable recibe TRUE si el recuento de referencias es cero después de que TmDereferenceEnlistmentKey lo decrezca. De lo contrario, la variable recibe FALSE.
Valor devuelto
TmDereferenceEnlistmentKey devuelve STATUS_SUCCESS si la operación se realiza correctamente. De lo contrario, esta rutina podría devolver uno de los siguientes valores:
| Código devuelto | Descripción |
|---|---|
|
El recuento de referencias del objeto de inscripción especificado es cero y no se puede disminuir. |
La rutina podría devolver otros valores NTSTATUS.
Comentarios
La rutina TmReferenceEnlistmentKey incrementa el recuento de referencias para la clave de un objeto de inscripción y la rutina TmDereferenceEnlistmentKey disminuye el recuento.
Para obtener información sobre cuándo usar las rutinas TmXxx de KTM en lugar de las rutinas ZwXxx , consulte Uso de rutinas TmXxx.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Disponible en Windows Vista y versiones posteriores del sistema operativo. |
| Plataforma de destino | Universal |
| Encabezado | wdm.h (incluya Wdm.h, Ntddk.h, Ntifs.h) |
| Library | NtosKrnl.lib |
| Archivo DLL | NtosKrnl.exe |
| IRQL | <= DISPATCH_LEVEL |