RtlCreateSystemVolumeInformationFolder routine

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


NTSTATUS RtlCreateSystemVolumeInformationFolder(
  _In_ PCUNICODE_STRING VolumeRootPath
);

Parameters

VolumeRootPath [in]

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 codeDescription
STATUS_INSUFFICIENT_RESOURCES

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 the documentation on these topics in the Microsoft Windows SDK.

Requirements

Target platform

Universal

Version

This routine is available on Windows XP and later Windows operating systems.

Header

Ntifs.h (include Ntifs.h or FltKernel.h)

Library

NtosKrnl.lib

DLL

NtosKrnl.exe

IRQL

PASSIVE_LEVEL

See also

ACE
ACL

 

 

Send comments about this topic to Microsoft

Show: