Функция TmDereferenceEnlistmentKey (wdm.h)
Подпрограмма 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, если операция выполнена успешно. В противном случае эта подпрограмма может возвращать одно из следующих значений:
| Код возврата | Описание |
|---|---|
|
Число ссылок указанного объекта зачисления равно нулю и не может быть уменьшено. |
Подпрограмма может возвращать другие значения NTSTATUS.
Комментарии
Подпрограмма TmReferenceEnlistmentKey увеличивает число ссылок для ключа объекта зачисления, а подпрограмма TmDereferenceEnlistmentKey уменьшает счетчик.
Сведения о том, когда следует использовать подпрограммы KTM TmXxx вместо процедур ZwXxx , см. в разделе Использование подпрограмм TmXxx.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Доступно в Windows Vista и более поздних версиях операционной системы. |
| Целевая платформа | Универсальное |
| Верхняя часть | wdm.h (включая Wdm.h, Ntddk.h, Ntifs.h) |
| Библиотека | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= DISPATCH_LEVEL |