structure NETWORK_OPEN_ECP_CONTEXT (ntifs.h)
La structure NETWORK_OPEN_ECP_CONTEXT est utilisée pour interpréter les contextes de paramètre de création de réseau (ECP) 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 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.in.Flags
Prise en charge à partir de Windows 7. Valeur qui spécifie les attributs du fichier. Ce membre est une 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 piggybacked et réduite sur 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é du 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éant un fichier ouvert pour l’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é à une utilisation 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 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
Valeur NETWORK_OPEN_INTEGRITY_QUALIFIER-typée qui spécifie la restriction d’intégrité à joindre au fichier.
DUMMYSTRUCTNAME.out.Flags
Prise en charge à partir de Windows 7. Valeur qui spécifie les attributs du fichier. Ce membre est une 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 piggybacked et réduite sur 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é du 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éant un fichier ouvert pour l’opération durable. |
| NETWORK_OPEN_ECP_IN_FLAG_FORCE_BUFFERED_SYNCHRONOUS_IO_HACK (0x80000000) | Réservé à une utilisation 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 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, l’appelant doit appeler la routine FltIsEcpAcknowledded ou FsRtlIsEcpAcknowledged routine sur l’ECP une fois l’opération terminée.
Les pilotes qui s’exécutent sur Windows 7 et 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 DUMMYSTRUCTNAME.in.Flags et DUMMYSTRUCTNAME.out.Flags membres ne sont pris en charge qu’à partir de Windows 7.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Cette structure est disponible à partir de Windows Vista. |
| d’en-tête | ntifs.h (include Ntifs.h) |