RtlCreateSystemVolumeInformationFolder 函数 (ntifs.h)
RtlCreateSystemVolumeInformationFolder 例程验证文件系统卷上是否存在“系统卷信息”文件夹。 如果该文件夹不存在,则会创建该文件夹。
语法
NTSYSAPI NTSTATUS RtlCreateSystemVolumeInformationFolder(
[in] PCUNICODE_STRING VolumeRootPath
);
参数
[in] VolumeRootPath
指向卷根路径的指针。
返回值
RtlCreateSystemVolumeInformationFolder 例程返回STATUS_SUCCESS或适当的错误状态,表示操作的最终完成状态。 可能的错误状态代码包括以下内容:
返回代码 | 说明 |
---|---|
|
无法分配此函数所需的临时缓冲区。 |
注解
RtlCreateSystemVolumeInformationFolder 例程验证给定卷上是否存在“系统卷信息”文件夹。
如果该文件夹不存在,则会创建该文件夹。 如果卷是 NTFS 卷,则使用访问控制列表创建文件夹, (ACL) 包含一个访问控制项 (ACE) 指示本地 SYSTEM 帐户的完全访问权限,并且 ACE 将设置继承位。 将使用设置FILE_ATTRIBUTE_HIDDEN和FILE_ATTRIBUTE_SYSTEM属性创建文件夹。
如果文件夹已存在,并且卷是 NTFS 卷,则会检查指示 SYSTEM 完全控制的 ACE,并在必要时对其进行修改以设置继承位。
有关安全性和访问控制的详细信息,请参阅 面向驱动程序开发人员的 Windows 安全模型 以及 Windows SDK 中有关这些主题的文档。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows XP |
目标平台 | 通用 |
标头 | ntifs.h (包括 Ntifs.h、FltKernel.h) |
Library | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | PASSIVE_LEVEL |