RtlCreateSystemVolumeInformationFolder-Funktion (ntifs.h)

Die RtlCreateSystemVolumeInformationFolder-Routine überprüft das Vorhandensein des Ordners "Systemvolumeinformationen" 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 Stammverzeichnis des Volumes.

Rückgabewert

Die RtlCreateSystemVolumeInformationFolder-Routine gibt STATUS_SUCCESS oder einen geeigneten Fehler zurück, status den endgültigen Abschluss status des Vorgangs darstellt. Mögliche Fehler status Codes:

Rückgabecode	Beschreibung
STATUS_INSUFFICIENT_RESOURCES	Ein temporärer Puffer, der für diese Funktion erforderlich ist, konnte nicht zugeordnet werden.

Hinweise

Die RtlCreateSystemVolumeInformationFolder-Routine überprüft das Vorhandensein des Ordners "Systemvolumeinformationen" 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 (Access Control List, ACL) erstellt, die einen Zugriffssteuerungseintrag (Access Control Entry, ACE) enthält, der vollzugriff für das lokale SYSTEMkonto angibt, und auf dem ACE sind die Vererbungsbits festgelegt. Der Ordner wird erstellt, wobei die Attribute FILE_ATTRIBUTE_HIDDEN und FILE_ATTRIBUTE_SYSTEM festgelegt sind.

Wenn der Ordner bereits vorhanden ist und das Volume ein NTFS-Volume ist, wird der ACE, der die vollständige Kontrolle für SYSTEM angibt, überprüft und bei Bedarf geändert, um die Vererbungsbits festzulegen.

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

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP
Zielplattform	Universell
Header	ntifs.h (include Ntifs.h, FltKernel.h)
Bibliothek	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL

Weitere Informationen

ASS

ACL