structure FILE_DISPOSITION_INFORMATION_EX (ntddk.h)
La structure FILE_DISPOSITION_INFORMATION_EX est utilisée comme argument de la routine ZwSetInformationFile et indique comment le système d’exploitation doit supprimer un fichier.
Syntaxe
typedef struct _FILE_DISPOSITION_INFORMATION_EX {
ULONG Flags;
} FILE_DISPOSITION_INFORMATION_EX, *PFILE_DISPOSITION_INFORMATION_EX;
Membres
Flags
Spécifie les actions que le système doit effectuer avec un fichier spécifique lors de la suppression.
| Nom de l’indicateur | Valeur | Signification |
|---|---|---|
| FILE_DISPOSITION_DO_NOT_DELETE | 0x00000000 | Spécifie que le système ne doit pas supprimer un fichier. |
| FILE_DISPOSITION_DELETE | 0x00000001 | Spécifie que le système doit supprimer un fichier. |
| FILE_DISPOSITION_POSIX_SEMANTICS | 0x00000002 | Spécifie que le système doit effectuer une suppression de style POSIX. Pour plus d’informations, consultez Remarques. |
| FILE_DISPOSITION_FORCE_IMAGE_SECTION_CHECK | 0x00000004 | Spécifie que le système doit forcer une section d’image case activée. |
| FILE_DISPOSITION_ON_CLOSE | 0x00000008 | Spécifie si le système définit ou efface l’état de fermeture. |
| FILE_DISPOSITION_IGNORE_READONLY_ATTRIBUTE | 0x00000010 | Autorise la suppression des fichiers en lecture seule. Pour plus d’informations, consultez la section Remarques ci-dessous. |
Remarques
L’appelant doit disposer d’un accès DELETE à un fichier donné pour appeler ZwSetInformationFile avec FILE_DISPOSITION_DELETE.
Lorsque FILE_DISPOSITION_POSIX_SEMANTICS n’est pas défini, un fichier marqué pour suppression n’est pas réellement supprimé tant que tous les handles ouverts du fichier n’ont pas été fermés et que le nombre de liens pour le fichier est égal à zéro. Lorsque FILE_DISPOSITION_POSIX_SEMANTICS est défini, le lien est supprimé de l’espace de noms visible dès que le handle de suppression POSIX a été fermé, mais les flux de données du fichier restent accessibles par d’autres handles existants jusqu’à ce que le dernier handle ait été fermé. Autrement dit, les applications qui avaient déjà le fichier ouvert peuvent toujours utiliser leur handle pour lire/écrire même si le nom qu’elles ont utilisé pour l’ouvrir a disparu et que le nombre de liens du fichier a peut-être atteint zéro.
Si le fichier est supprimé à la demande de l’utilisateur, l’utilisation de la sémantique POSIX permet au système de supprimer le fichier comme demandé, mais permet également à tout processus avec un handle ouvert de continuer à accéder aux données du fichier tant que le handle est ouvert.
Une valeur de retour de STATUS_CANNOT_DELETE indique que le fichier est en lecture seule ou qu’il existe une vue mappée existante au fichier.
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête | ntddk.h (inclure Ntddk.h, Ntifs.h) |