Función TmDereferenceEnlistmentKey (wdm.h)

Artículo
02/27/2024

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
STATUS_UNSUCCESSFUL	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