Partager via


structure ECP_OPEN_PARAMETERS (ntifs.h)

La structure ECP_OPEN_PARAMETERS contient le contexte de création supplémentaire des paramètres (ECP) qui permet à un appelant de spécifier l’objectif d’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 une utilisation ultérieure. Cette opération doit être initialisée à 0.

Flags

Indicateurs qui spécifient les paramètres ou l’objectif de l’ouverture d’un fichier. 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 l’é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 une recherche non sensible à la casse pour ce fichier ouvert, même sous 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 la demande d’ouverture ou de création du fichier si le chemin d’accès contient des répertoires sensibles à 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 n’est généralement pas effectuée lorsque les fichiers ne sont pas ouverts pour l’accès en lecture/écriture.

La valeur de 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 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 1709.
d’en-tête ntifs.h (include Ntifs.h)

Voir aussi

FltAllocateExtraCreateParameterList

FltCreateFileEx2