structure ECP_OPEN_PARAMETERS (ntifs.h)

  • Article

La structure ECP_OPEN_PARAMETERS contient le contexte des paramètres de création supplémentaires (ECP) qui permet à un appelant de spécifier l’objectif de l’ouverture d’un fichier sans interférer avec les handles existants et/ou les verrous opportunistes (oplocks) sur le fichier.

Syntaxe

typedef struct _ECP_OPEN_PARAMETERS {
  USHORT Size;
  USHORT Reserved;
  ULONG  Flags;
} ECP_OPEN_PARAMETERS, *PECP_OPEN_PARAMETERS;

Membres

Size

Spécifie la taille de cette structure de contexte, en octets.

Reserved

Réservé pour un usage futur. Cela doit être initialisé sur 0.

Flags

Indicateurs qui spécifient les paramètres ou l’objectif d’ouverture d’un fichier. Les indicateurs peuvent être n’importe quelle combinaison des valeurs suivantes :

Valeur Description
ECP_OPEN_PARAMETERS_FLAG_OPEN_FOR_READ (0x0001) Ouverture du fichier pour le lire.
ECP_OPEN_PARAMETERS_FLAG_OPEN_FOR_WRITE (0x0002) Ouverture du fichier pour y écrire.
ECP_OPEN_PARAMETERS_FLAG_OPEN_FOR_DELETE (0x0004) Ouverture du fichier pour le supprimer.
ECP_OPEN_PARAMETERS_FLAG_IGNORE_DIR_CASE_SENSITIVITY (0x0008) Force l’ouverture d’une recherche qui ne respecte pas la casse pour ce fichier, même dans un répertoire respectant la casse. Disponible à partir de Windows 10 version 2004.
ECP_OPEN_PARAMETERS_FLAG_FAIL_ON_CASE_SENSITIVE_DIR ( 0x0010) Échec de l’ouverture du fichier ou de la demande de création si le chemin d’accès a des répertoires respectant la casse. Disponible à partir de Windows 10 version 2004.

Remarques

Les indicateurs ECP_OPEN_PARAMETERS_FLAG_OPEN_FOR_READ et ECP_OPEN_PARAMETERS_FLAG_OPEN_FOR_WRITE autorisent l’accès en lecture/écriture aux fichiers chiffrés sans avoir à ouvrir ces fichiers pour l’accès en lecture/écriture. Ces indicateurs ECP permettent à un composant en mode noyau de s’ouvrir pour l’accès aux métadonnées uniquement, ce qui n’interfère pas avec d’autres accès tout en obtenant la configuration du contexte de chiffrement afin d’effectuer des lectures/écritures. Un filtre peut définir ces indicateurs pour éviter les conflits avec le verrouillage. La configuration de l’état de chiffrement pour les opérations de lecture/écriture est coûteuse et ne s’effectue généralement pas lorsque les fichiers ne sont pas ouverts pour l’accès en lecture/écriture.

La valeur GUID_ECP_OPEN_PARAMETERS définie par le système est utilisée avec cette structure de contexte ECP lors de l’appel de routines de prise en charge liées à ECP telles que FltAllocateExtraCreateParameter et FsRtlRemoveExtraCreateParameter.

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

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 10, version 1709.
En-tête ntifs.h (inclure Ntifs.h)

Voir aussi

FltAllocateExtraCreateParameterList

FltCreateFileEx2