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

Статья
02/29/2024

Подпрограмма RtlCreateSystemVolumeInformationFolder проверяет наличие папки "Сведения о системном томе" на томе файловой системы. Если папка отсутствует, она создается.

Синтаксис

NTSYSAPI NTSTATUS RtlCreateSystemVolumeInformationFolder(
  [in] PCUNICODE_STRING VolumeRootPath
);

Параметры

[in] VolumeRootPath

Указатель на путь к корню тома.

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

Подпрограмма RtlCreateSystemVolumeInformationFolder возвращает STATUS_SUCCESS или соответствующее состояние ошибки, представляющее окончательное состояние завершения операции. Возможные коды состояния ошибок:

Код возврата	Описание
STATUS_INSUFFICIENT_RESOURCES	Не удалось выделить временный буфер, необходимый для этой функции.

Если папка отсутствует, она создается. Если том является томом NTFS, папка создается со списком управления доступом (ACL), содержащим одну запись управления доступом (ACE), указывающую полный доступ для локальной учетной записи SYSTEM, а для ACE будут заданы биты наследования. Папка будет создана с набором атрибутов FILE_ATTRIBUTE_HIDDEN и FILE_ATTRIBUTE_SYSTEM.

Если папка уже существует, а том является томом NTFS, ACE, указывающий на полный контроль для SYSTEM, будет проверяться и при необходимости изменяться для установки битов наследования.

Дополнительные сведения о безопасности и управлении доступом см. в статье Модель безопасности Windows для разработчиков драйверов и в документации по этим темам в Windows SDK.

Требования

Требование	Значение
Минимальная версия клиента	Windows XP
Целевая платформа	Универсальное
Верхняя часть	ntifs.h (включая Ntifs.h, FltKernel.h)
Библиотека	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL

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

ACE

ACL

Share via