RtlCreateSystemVolumeInformationFolder function (ntifs.h)
The RtlCreateSystemVolumeInformationFolder routine verifies the existence of the "System Volume Information" folder on a file system volume. If the folder is not present, then the folder is created.
Syntax
NTSYSAPI NTSTATUS RtlCreateSystemVolumeInformationFolder(
[in] PCUNICODE_STRING VolumeRootPath
);
Parameters
[in] VolumeRootPath
A pointer to a path to the root of the volume.
Return value
The RtlCreateSystemVolumeInformationFolder routine returns STATUS_SUCCESS or an appropriate error status representing the final completion status of the operation. Possible error status codes include the following:
| Return code | Description |
|---|---|
|
A temporary buffer required by this function could not be allocated. |
Remarks
The RtlCreateSystemVolumeInformationFolder routine verifies the existence of the "System Volume Information" folder on the given volume.
If the folder is not present, then the folder is created. If the volume is an NTFS volume, the folder is created with an access control list (ACL) containing one access control entry (ACE) indicating full access for the local SYSTEM account, and the ACE will have the inheritance bits set. The folder will be created with the FILE_ATTRIBUTE_HIDDEN and FILE_ATTRIBUTE_SYSTEM attributes set.
If the folder is already present and the volume is an NTFS volume, the ACE that indicates full control for SYSTEM will be checked and if necessary modified to have the inheritance bits set.
For more information about security and access control, see Windows security model for driver developers and the documentation on these topics in the Windows SDK.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows XP |
| Target Platform | Universal |
| Header | ntifs.h (include Ntifs.h, FltKernel.h) |
| Library | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |