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