structure NETWORK_OPEN_ECP_CONTEXT (ntifs.h)

Article
08/07/2023

La structure NETWORK_OPEN_ECP_CONTEXT est utilisée pour interpréter les contextes ecP (Network Extra Create Parameter) sur les fichiers.

Syntaxe

typedef struct _NETWORK_OPEN_ECP_CONTEXT {
  USHORT Size;
  USHORT Reserved;
  struct {
    struct {
      NETWORK_OPEN_LOCATION_QUALIFIER  Location;
      NETWORK_OPEN_INTEGRITY_QUALIFIER Integrity;
      NETWORK_OPEN_IN_FLAGS            Flags;
    } in;
    struct {
      NETWORK_OPEN_LOCATION_QUALIFIER  Location;
      NETWORK_OPEN_INTEGRITY_QUALIFIER Integrity;
      NETWORK_OPEN_OUT_FLAGS           Flags;
    } out;
  } DUMMYSTRUCTNAME;
} NETWORK_OPEN_ECP_CONTEXT, *PNETWORK_OPEN_ECP_CONTEXT;

Membres

Size

Taille, en octets, de cette structure.

Reserved

Réservé. Doit être défini sur zéro.

DUMMYSTRUCTNAME

Structure qui contient des restrictions à appliquer pour l’ouverture du fichier (précréer) et l’appliquer au fichier après son ouverture (post-création).

DUMMYSTRUCTNAME.in

Structure qui contient des restrictions de précréer pour l’ouverture d’un fichier.

DUMMYSTRUCTNAME.in.Location

Valeur de type NETWORK_OPEN_LOCATION_QUALIFIER qui spécifie la restriction d’emplacement à joindre au fichier.

DUMMYSTRUCTNAME.in.Integrity

Valeur de type NETWORK_OPEN_INTEGRITY_QUALIFIER qui spécifie la restriction d’intégrité à joindre au fichier.

DUMMYSTRUCTNAME.in.Flags

Pris en charge à partir de Windows 7. Valeur qui spécifie les attributs du fichier. Ce membre est un or au niveau du bit de l’un des indicateurs suivants.

Valeur	Signification
NETWORK_OPEN_ECP_IN_FLAG_DISABLE_HANDLE_COLLAPSING (0x1)	Indique au redirecteur SMB que la requête ouverte entrante ne doit pas être piggybackée et réduite dans un handle ouvert existant dans le même fichier.
NETWORK_OPEN_ECP_IN_FLAG_DISABLE_HANDLE_DURABILITY (0x2)	Provoque la désactivation de la durabilité par le redirecteur SMB2+ sur ce handle ouvert. Pour plus d’informations sur l’ouverture d’un fichier pour une opération durable, consultez Demandes d’application création d’un fichier ouvert pour une opération durable.
NETWORK_OPEN_ECP_IN_FLAG_DISABLE_OPLOCKS (0x4)	Indique au redirecteur SMB de ne pas accorder d’oplocks pour la requête ouverte entrante. Cet indicateur est disponible à partir de Windows 8.
NETWORK_OPEN_ECP_IN_FLAG_FORCE_BUFFERED_SYNCHRONOUS_IO_HACK (0x80000000)	Réservé à un usage interne et ne doit pas être utilisé par les applications. Cet indicateur force le redirecteur à utiliser des E/S synchrones même si le handle a été ouvert pour les E/S asynchrones.

DUMMYSTRUCTNAME.out

Structure qui contient des restrictions post-création à appliquer à un fichier après son ouverture.

DUMMYSTRUCTNAME.out.Location

Valeur de type NETWORK_OPEN_LOCATION_QUALIFIER qui spécifie la restriction d’emplacement à joindre au fichier.

DUMMYSTRUCTNAME.out.Integrity

Valeur de type NETWORK_OPEN_INTEGRITY_QUALIFIER qui spécifie la restriction d’intégrité à joindre au fichier.

DUMMYSTRUCTNAME.out.Flags

Pris en charge à partir de Windows 7. Valeur qui spécifie les attributs du fichier. Ce membre est un or au niveau du bit de l’un des indicateurs suivants.

Valeur	Signification
NETWORK_OPEN_ECP_IN_FLAG_DISABLE_HANDLE_COLLAPSING (0x1)	Indique au redirecteur SMB que la requête ouverte entrante ne doit pas être piggybackée et réduite dans un handle ouvert existant dans le même fichier.
NETWORK_OPEN_ECP_IN_FLAG_DISABLE_HANDLE_DURABILITY (0x2)	Provoque la désactivation de la durabilité par le redirecteur SMB2+ sur ce handle ouvert. Pour plus d’informations sur l’ouverture d’un fichier pour une opération durable, consultez Demandes d’application création d’un fichier ouvert pour une opération durable.
NETWORK_OPEN_ECP_IN_FLAG_FORCE_BUFFERED_SYNCHRONOUS_IO_HACK (0x80000000)	Réservé à un usage interne et ne doit pas être utilisé par les applications. Cet indicateur force le redirecteur à utiliser des E/S synchrones même si le handle a été ouvert pour les E/S asynchrones.

Remarques

Pour plus d’informations sur l’utilisation des programmes d’environnement pour associer des informations supplémentaires à un fichier lors de la création du fichier, consultez Utilisation de paramètres de création supplémentaires avec une opération de IRP_MJ_CREATE.

Un pilote de filtre doit considérer la structure NETWORK_OPEN_ECP_CONTEXT en lecture seule, en l’utilisant uniquement pour récupérer des informations sur le contexte ECP réseau sur un fichier. Pour plus d’informations, consultez EcPs définis par le système.

Si un appelant doit vérifier que le système de fichiers a reconnu la structure de contexte NETWORK_OPEN_ECP_CONTEXT , l’appelant doit appeler la routine FltIsEcpAcknowledged ou FsRtlIsEcpAcknowledged sur l’ECP une fois l’opération terminée.

Les pilotes qui s’exécutent sur Windows 7 et les versions ultérieures de Windows et qui doivent interpréter les contextes ECP réseau sur les fichiers qui résident sur Windows Vista doivent utiliser la structure NETWORK_OPEN_ECP_CONTEXT_V0 à la place.

Les pilotes qui s’exécutent sur Windows Vista et les versions ultérieures de Windows utilisent la structure NETWORK_OPEN_ECP_CONTEXT pour interpréter les contextes ECP réseau sur les fichiers. Toutefois, les membres DUMMYSTRUCTNAME.in.Flags et DUMMYSTRUCTNAME.out.Flags ne sont pris en charge qu’à partir de Windows 7.