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

  • Статья

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

Синтаксис

NTSYSAPI NTSTATUS ZwMakeTemporaryObject(
  [in] HANDLE Handle
);

Параметры

[in] Handle

Дескриптор объекта любого типа.

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

ZwMakeTemporaryObject возвращает STATUS_SUCCESS при успешном выполнении или соответствующий код ошибки NTSTATUS при сбое.

Комментарии

ZwMakeTemporaryObject — это универсальная подпрограмма, которая работает с объектом любого типа.

Объект является постоянным, если он был создан с указанным атрибутом объекта OBJ_PERMANENT. (Дополнительные сведения об атрибутах объекта см. в разделе InitializeObjectAttributes.) Постоянный объект создается с числом ссылок 1, поэтому он не удаляется, когда драйвер разыменовывает его.

Объект является временным, если он не является постоянным. ZwMakeTemporaryObject преобразует указанный объект во временный объект. Если объект уже является временным, эта подпрограмма не выполняет никаких действий.

Временный объект имеет имя только при условии, что его число дескрипторов больше нуля. Когда число дескрипторов достигает нуля, система удаляет имя объекта и соответствующим образом корректирует число указателей объекта.

Если вызов этой функции происходит в пользовательском режиме, следует использовать имя NtMakeTemporaryObject вместо ZwMakeTemporaryObject.

Для вызовов из драйверов режима ядра версии NtXxx и ZwXxx подпрограммы собственных системных служб Windows могут вести себя по-разному, так как они обрабатывают и интерпретируют входные параметры. Дополнительные сведения о связи между версиями процедуры NtXxx и ZwXxx см. в разделе Использование версий Nt и Zw для процедур собственных системных служб.

Требования

Требование Значение
Целевая платформа Универсальное
Верхняя часть wdm.h (включая Wdm.h, Ntddk.h, Ntifs.h)
Библиотека NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL
Правила соответствия DDI HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm)

См. также раздел

InitializeObjectAttributes

Использование версий Nt и Zw собственных процедур системных служб

ZwClose

ZwCreateDirectoryObject

ZwCreateFile