Partager via


Fonction RtlCreateSystemVolumeInformationFolder (ntifs.h)

La routine RtlCreateSystemVolumeInformationFolder vérifie l’existence du dossier « System Volume Information » sur un volume de système de fichiers. Si le dossier n’est pas présent, le dossier est créé.

Syntaxe

NTSYSAPI NTSTATUS RtlCreateSystemVolumeInformationFolder(
  [in] PCUNICODE_STRING VolumeRootPath
);

Paramètres

[in] VolumeRootPath

Pointeur vers un chemin d’accès à la racine du volume.

Valeur retournée

La routine RtlCreateSystemVolumeInformationFolder retourne STATUS_SUCCESS ou une erreur appropriée status représentant le status d’achèvement final de l’opération. Les codes status d’erreur possibles sont les suivants :

Code de retour Description
STATUS_INSUFFICIENT_RESOURCES
Une mémoire tampon temporaire requise par cette fonction n’a pas pu être allouée.

Remarques

La routine RtlCreateSystemVolumeInformationFolder vérifie l’existence du dossier « System Volume Information » sur le volume donné.

Si le dossier n’est pas présent, le dossier est créé. Si le volume est un volume NTFS, le dossier est créé avec une liste de contrôle d’accès (ACL) contenant une entrée de contrôle d’accès (ACE) indiquant un accès complet pour le compte SYSTEM local, et l’ACE aura les bits d’héritage définis. Le dossier est créé avec les attributs FILE_ATTRIBUTE_HIDDEN et FILE_ATTRIBUTE_SYSTEM définis.

Si le dossier est déjà présent et que le volume est un volume NTFS, l’ACE qui indique le contrôle total pour SYSTEM est vérifié et, si nécessaire, modifié pour que les bits d’héritage soient définis.

Pour plus d’informations sur la sécurité et le contrôle d’accès, consultez Modèle de sécurité Windows pour les développeurs de pilotes et la documentation sur ces rubriques dans le Kit de développement logiciel (SDK) Windows.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP
Plateforme cible Universal
En-tête ntifs.h (include Ntifs.h, FltKernel.h)
Bibliothèque NtosKrnl.lib
DLL NtosKrnl.exe
IRQL PASSIVE_LEVEL

Voir aussi

ACE

ACL