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 de retour
La routine RtlCreateSystemVolumeInformationFolder retourne STATUS_SUCCESS ou un état d’erreur approprié représentant l’état d’achèvement final de l’opération. Les codes d’état d’erreur possibles sont les suivants :
| Retourner le code | Description |
|---|---|
|
Impossible d’allouer une mémoire tampon temporaire requise par cette fonction. |
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 l’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.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows XP |
| plateforme cible | Universel |
| d’en-tête | ntifs.h (include Ntifs.h, FltKernel.h) |
| bibliothèque | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |