Fonction FltCreateSystemVolumeInformationFolder (fltkernel.h)

Article
02/29/2024

FltCreateSystemVolumeInformationFolder 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

NTSTATUS FLTAPI FltCreateSystemVolumeInformationFolder(
  [in] PFLT_INSTANCE Instance
);

Paramètres

[in] Instance

Pointeur de instance opaque pour un instance attaché au volume.

Valeur retournée

FltCreateSystemVolumeInformationFolder 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

FltCreateSystemVolumeInformationFolder vérifie l’existence du dossier « System Volume Information » dans le répertoire racine du volume auquel l’instance donnée est attachée.

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 la documentation sur ces rubriques dans le Microsoft Windows SDK.