Функция IoReplaceFileObjectName (ntifs.h)

Статья
02/07/2025

Подпрограмма IoReplaceFileObjectName заменяет имя объекта файла.

Синтаксис

NTSTATUS IoReplaceFileObjectName(
  [in] PFILE_OBJECT FileObject,
  [in] PWSTR        NewFileName,
  [in] USHORT       FileNameLength
);

Параметры

[in] FileObject

Указатель на объект файла, имя файла которого заменяется.

[in] NewFileName

Указатель на буфер строки для нового имени объекта файла.

[in] FileNameLength

Длина в байтах нового имени для объекта файла.

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

Возвращает STATUS_SUCCESS или одно из следующих значений NTSTATUS в противном случае:

Возвращаемый код	Описание
STATUS_INVALID_PARAMETER	Предоставленный объект файла не имеет имени для замены.
STATUS_INSUFFICIENT_RESOURCES	Неадекватная память доступна для выделения буфера для выполнения этой операции.

Замечания

Драйверы должны использовать IoReplaceFileObjectName для безопасного замены имени в объекте файла. Это позволяет диспетчеру ввода-вывода управлять временем существования буфера, связанного с объектом файла. Замена имени объекта файла непосредственно без использования IoReplaceFileObjectName может конфликтовать с другим использованием имени и следует избегать, если это возможно.

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 7
целевая платформа	Всеобщий
заголовка	ntifs.h (include Ntifs.h)
библиотеки	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL

Поделиться через