Функция TmDereferenceEnlistmentKey (wdm.h)

Статья
08/08/2023

Подпрограмма TmDereferenceEnlistmentKey уменьшает количество ссылок для ключа указанного объекта зачисления.

Синтаксис

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

Параметры

[in] Enlistment

Указатель на объект зачисления. Компонент может получать этот указатель в качестве входных данных для процедуры обратного вызова ResourceManagerNotification . Кроме того, компонент может вызвать ObReferenceObjectByHandle и предоставить дескриптор объекта, указанный при предыдущем вызове ZwCreateEnlistment, TmCreateEnlistment или ZwOpenEnlistment .

[out, optional] LastReference

Указатель на переменную типа BOOLEAN. Эта переменная получает значение TRUE , если число ссылок равно нулю после уменьшения значения TmDereferenceEnlistmentKey . В противном случае переменная получает значение FALSE.

Возвращаемое значение

TmDereferenceEnlistmentKey возвращает STATUS_SUCCESS, если операция выполнена успешно. В противном случае эта подпрограмма может возвращать одно из следующих значений:

Код возврата	Описание
STATUS_UNSUCCESSFUL	Число ссылок указанного объекта зачисления равно нулю и не может быть уменьшено.

Подпрограмма может возвращать другие значения NTSTATUS.

Требования

Требование	Значение
Минимальная версия клиента	Доступно в Windows Vista и более поздних версиях операционной системы.
Целевая платформа	Универсальное
Верхняя часть	wdm.h (включая Wdm.h, Ntddk.h, Ntifs.h)
Библиотека	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= DISPATCH_LEVEL