structure NETWORK_OPEN_ECP_CONTEXT_V0 (ntifs.h)

Article
02/29/2024

La structure NETWORK_OPEN_ECP_CONTEXT_V0 est utilisée pour interpréter les contextes de paramètre de création supplémentaire réseau (ECP) sur les fichiers.

Syntaxe

typedef struct _NETWORK_OPEN_ECP_CONTEXT_V0 {
  USHORT Size;
  USHORT Reserved;
  struct {
    struct {
      NETWORK_OPEN_LOCATION_QUALIFIER  Location;
      NETWORK_OPEN_INTEGRITY_QUALIFIER Integrity;
    } in;
    struct {
      NETWORK_OPEN_LOCATION_QUALIFIER  Location;
      NETWORK_OPEN_INTEGRITY_QUALIFIER Integrity;
    } out;
  } DUMMYSTRUCTNAME;
} NETWORK_OPEN_ECP_CONTEXT_V0, *PNETWORK_OPEN_ECP_CONTEXT_V0;

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 préalables à la création pour l’ouverture d’un fichier.

DUMMYSTRUCTNAME.in.Location

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

DUMMYSTRUCTNAME.in.Integrity

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

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 à attacher au fichier.

DUMMYSTRUCTNAME.out.Integrity

Ce membre n’est actuellement pas implémenté et doit être ignoré.

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

Remarques

Pour plus d’informations sur l’utilisation des ecps 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 comme étant 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 Les fournisseurs d’environnement 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_V0 , l’appelant doit appeler la routine FltIsEcpAcknowledged ou FsRtlIsEcpAcknowledged sur l’ECP une fois l’opération terminée.

Dans la plupart des cas, 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 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.