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

  • Статья
  • Чтение занимает 2 мин

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

Синтаксис

NTSYSAPI NTSTATUS ZwMakeTemporaryObject(
  [in] HANDLE Handle
);

Параметры

[in] Handle

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

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

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

Комментарии

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

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

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

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

Примечание Если вызов этой функции происходит в пользовательском режиме, следует использовать имя NtMakeTemporaryObject вместо ZwMakeTemporaryObject.
 
Для вызовов из драйверов в режиме ядра версии подпрограммы Windows Native System Services NtXxx и Zwмогут вести себя по-разному так, как они обрабатывают и интерпретируют входные параметры. Дополнительные сведения о связях между подпрограммами NtXxx и ZwXxx см. в разделе "Использование версий Nt и Zw" подпрограмм собственных системных служб.

Требования

   
Минимальная версия клиента Доступно начиная с Windows 2000.
Целевая платформа Универсальное
Заголовок wdm.h (include 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