structure ATOMIC_CREATE_ECP_CONTEXT (ntifs.h)

La structure ATOMIC_CREATE_ECP_CONTEXT contient le contexte de paramètre de création supplémentaire (ECP) qui permet d’effectuer des opérations supplémentaires sur un fichier de manière atomique pendant la création.

Syntaxe

typedef struct _ATOMIC_CREATE_ECP_CONTEXT {
  USHORT               Size;
  USHORT               InFlags;
  USHORT               OutFlags;
  USHORT               ReparseBufferLength;
  PREPARSE_DATA_BUFFER ReparseBuffer;
  LONGLONG             FileSize;
  LONGLONG             ValidDataLength;
  PFILE_TIMESTAMPS     FileTimestamps;
  ULONG                FileAttributes;
  ULONG                UsnSourceInfo;
  USN                  Usn;
  ULONG                SuppressFileAttributeInheritanceMask;
  ULONG                InOpFlags;
  ULONG                OutOpFlags;
  ULONG                InGenFlags;
  ULONG                OutGenFlags;
  ULONG                CaseSensitiveFlagsMask;
  ULONG                InCaseSensitiveFlags;
  ULONG                OutCaseSensitiveFlags;
} ATOMIC_CREATE_ECP_CONTEXT, *PATOMIC_CREATE_ECP_CONTEXT;

Membres

Size

Taille de cette structure de contexte, en octets.

InFlags

Indicateurs qui indiquent la ou les opérations supplémentaires demandées à effectuer avec l’opération de création.

Valeur	Signification
ATOMIC_CREATE_ECP_IN_FLAG_SPARSE_SPECIFIED	Demande que l’indicateur éparse soit défini sur le fichier.
ATOMIC_CREATE_ECP_IN_FLAG_REPARSE_POINT_SPECIFIED	Demande qu’un point d’analyse soit défini sur le fichier.
ATOMIC_CREATE_ECP_IN_FLAG_EOF_SPECIFIED	Demande qu’une taille de fichier soit définie sur le fichier. Cela implique également
cette allocation sur disque se produit pour prendre en charge la taille de fichier demandée.
ATOMIC_CREATE_ECP_IN_FLAG_VDL_SPECIFIED	Demande qu’une longueur de données valide soit définie sur le fichier. Cela implique également que la taille du fichier soit définie sur au moins la longueur de données valide demandée. REMARQUE : il s’agit d’une opération privilégiée si elle pourrait potentiellement
exposer des données non initialisées.
ATOMIC_CREATE_ECP_IN_FLAG_OPERATION_MASK	Utilisez cet indicateur comme masque pour spécifier l’autre Valeurs d’indicateur InFlags.
ATOMIC_CREATE_ECP_IN_FLAG_BEST_EFFORT	Indique que le système de fichiers doit effectuer l’opération de création même si certaines des opérations supplémentaires demandées n’ont pas pu être
effectuées ou ne sont pas prises en charge par le système de fichiers. L’appelant peut vérifier OutFlags pour voir quelles opérations ont été effectuées. Si cet indicateur n’est pas spécifié, le système de fichiers doit échouer à l’opération de création si elle ne peut pas effectuer toutes les opérations supplémentaires demandées.

OutFlags

Indicateurs qui indiquent la ou les opérations supplémentaires réelles effectuées avec une opération de création réussie.

Valeur	Signification
ATOMIC_CREATE_ECP_OUT_FLAG_SPARSE_SET	Indique que l’indicateur éparse a été défini sur le fichier.
ATOMIC_CREATE_ECP_OUT_FLAG_REPARSE_POINT_SET	Indique qu’un point d’analyse a été défini sur le fichier.
ATOMIC_CREATE_ECP_OUT_FLAG_EOF_SET	Indique qu’une taille de fichier a été définie sur le fichier et que l’allocation sur disque s’est produite pour prendre en charge la taille de fichier demandée.
ATOMIC_CREATE_ECP_OUT_FLAG_VDL_SET	Indique qu’une longueur de données valide a été définie sur le fichier et que la taille du fichier a été définie sur au moins la longueur de données valide demandée.
ATOMIC_CREATE_ECP_OUT_FLAG_OPERATION_MASK	Utilisez cette valeur d’indicateur comme masque pour déterminer les opérations supplémentaires effectuées avec l’opération de création.

ReparseBufferLength

Longueur du membre ReparseBu ffer. Cette valeur ne peut pas dépasser la MAXIMUM_REPARSE_DATA_BUFFER_SIZE (16 Ko).

ReparseBuffer

Valeur facultative qui indique le type de mémoire tampon utilisée dans l’opération de création. Les valeurs possibles sont REPARSE_DATA_BUFFER ou REPARSE_GUID_DATA_BUFFER.

FileSize

Valeur facultative utilisée avec ATOMIC_CREATE_ECP_IN_FLAG_EOF_SPECIFIED pour indiquer la taille de fichier demandée à définir sur le fichier.

ValidDataLength

Valeur facultative utilisée avec ATOMIC_CREATE_ECP_IN_FLAG_VDL_SPECIFIED pour indiquer la longueur de données valide demandée à définir sur le fichier.

FileTimestamps

Pointeur vers une structure FILE_TIMESTAMPS facultative qui contient la dernière instance enregistrée d’actions spécifiques sur un fichier.

FileAttributes

Spécifie les attributs d’un fichier.

UsnSourceInfo

Spécifie les indicateurs d’informations sources USN (Update Sequence Number) facultatifs.

Usn

Spécifie le numéro de séquence de mise à jour (USN). Cette valeur est remplie à la fin de GUID_ECP_ATOMIC_CREATE .

SuppressFileAttributeInheritanceMask

Masque qui indique les attributs de fichier dont les règles d’héritage normales doivent être supprimées.

InOpFlags

ATOMIC_CREATE_ECP_IN_OP_FLAG_xxx indicateurs.

OutOpFlags

ATOMIC_CREATE_ECP_OUT_OP_FLAG_xxx indicateurs.

InGenFlags

ATOMIC_CREATE_ECP_IN_GN_FLAG_xxx indicateurs.

OutGenFlags

ATOMIC_CREATE_ECP_OUT_GN_FLAG_xxx indicateurs.

CaseSensitiveFlagsMask

Indique les indicateurs FILE_CS_FLAG_xxx spécifiés ; les systèmes de fichiers doivent choisir les valeurs par défaut pour d’autres indicateurs.

InCaseSensitiveFlags

Indicateurs sensibles à la casse d’entrée sur le fichier. Même si aucun BEST_EFFORT n’est spécifié, les systèmes de fichiers peuvent ignorer certaines des inCaseSensitiveFlags. Le comportement est similaire à FileCaseSensitiveInformation afin que les appelants puissent examiner OutCaseSensitiveFlags connaître les indicateurs définis. Si un indicateur n’est pas pris en charge sur un fichier ou un répertoire, BEST_EFFORT prend effet.

OutCaseSensitiveFlags

Ce membre retourne les indicateurs respectant la casse sur le fichier, même si aucun InCaseSensitiveFlags sont spécifiés.

Remarques

La valeur GUID_ECP_ATOMIC_CREATE** définie par le système est utilisée avec cette structure de contexte ECP lors de l’appel de routines de support ecP telles que FltAllocateExtraCreateParameter et FsRtlRemoveExtraCreateParameter.

Pour plus d’informations, consultez Présentation pour créer des paramètres supplémentaires.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 10, version 1607
serveur minimum pris en charge	Windows Server 2016
d’en-tête	ntifs.h