Freigeben über


RtlCreateSystemVolumeInformationFolder-Funktion (ntifs.h)

Die RtlCreateSystemVolumeInformationFolder Routine überprüft das Vorhandensein des Ordners "System Volume Information" auf einem Dateisystemvolume. Wenn der Ordner nicht vorhanden ist, wird der Ordner erstellt.

Syntax

NTSYSAPI NTSTATUS RtlCreateSystemVolumeInformationFolder(
  [in] PCUNICODE_STRING VolumeRootPath
);

Parameter

[in] VolumeRootPath

Ein Zeiger auf einen Pfad zum Stamm des Volumes.

Rückgabewert

Die RtlCreateSystemVolumeInformationFolder Routine gibt STATUS_SUCCESS oder einen entsprechenden Fehlerstatus zurück, der den endgültigen Abschlussstatus des Vorgangs darstellt. Mögliche Fehlerstatuscodes sind:

Rückgabecode Beschreibung
STATUS_INSUFFICIENT_RESOURCES
Ein temporärer Puffer, der von dieser Funktion benötigt wird, konnte nicht zugeordnet werden.

Bemerkungen

Die RtlCreateSystemVolumeInformationFolder Routine überprüft das Vorhandensein des Ordners "System Volume Information" auf dem angegebenen Volume.

Wenn der Ordner nicht vorhanden ist, wird der Ordner erstellt. Wenn es sich bei dem Volume um ein NTFS-Volume handelt, wird der Ordner mit einer Zugriffssteuerungsliste (ACL-) erstellt, die einen Zugriffssteuerungseintrag (ACE) enthält, der den vollzugriff auf das lokale SYSTEM-Konto angibt, und die ACE hat die Vererbungsbits festgelegt. Der Ordner wird mit den attributen FILE_ATTRIBUTE_HIDDEN und FILE_ATTRIBUTE_SYSTEM erstellt.

Wenn der Ordner bereits vorhanden ist und das Volume ein NTFS-Volume ist, wird die ACE, die vollzugriff auf SYSTEM angibt, überprüft und falls erforderlich geändert, damit die Vererbungsbits festgelegt sind.

Weitere Informationen zur Sicherheits- und Zugriffssteuerung finden Sie unter Windows-Sicherheitsmodell für Treiberentwickler und die Dokumentation zu diesen Themen im Windows SDK.

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Windows XP
Zielplattform- Universal
Header- ntifs.h (einschließlich Ntifs.h, FltKernel.h)
Library NtosKrnl.lib
DLL- NtosKrnl.exe
IRQL- PASSIVE_LEVEL

Siehe auch

ACE-

ACL-