structure ECP_OPEN_PARAMETERS (ntifs.h)

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 :

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

Voir aussi

FltAllocateExtraCreateParameterList

FltCreateFileEx2