structure NETWORK_OPEN_ECP_CONTEXT_V0 (ntifs.h)

Article
12/21/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 s’appliquer au fichier une fois qu’il a été ouvert (après la création).

DUMMYSTRUCTNAME.in

Structure qui contient des restrictions préalables à la création d’un fichier.

DUMMYSTRUCTNAME.in.Location

Valeur NETWORK_OPEN_LOCATION_QUALIFIER-typée qui spécifie la restriction d’emplacement à joindre au fichier.

DUMMYSTRUCTNAME.in.Integrity

Valeur NETWORK_OPEN_INTEGRITY_QUALIFIER-typée qui spécifie la restriction d’intégrité à joindre au fichier.

DUMMYSTRUCTNAME.out

Structure qui contient des restrictions post-création à appliquer à un fichier une fois qu’il a été ouvert.

DUMMYSTRUCTNAME.out.Location

Valeur NETWORK_OPEN_LOCATION_QUALIFIER-typée qui spécifie la restriction d’emplacement à joindre au fichier.

DUMMYSTRUCTNAME.out.Integrity

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

Valeur NETWORK_OPEN_INTEGRITY_QUALIFIER-typée qui spécifie la restriction d’intégrité à joindre au fichier.

Remarques

Pour plus d’informations sur l’utilisation d’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émentaire 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 System-Definedd’ecps .

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 routine 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.