structure NETWORK_APP_INSTANCE_ECP_CONTEXT (ntifs.h)

  • Article

La structure NETWORK_APP_INSTANCE_ECP_CONTEXT est un paramètre de création supplémentaire (ECP) et contient un identificateur de instance d’application à associer à un fichier. Cette structure permet d’identifier les fichiers ouverts pour une application cliente de cluster de basculement lorsque cette application reprend l’accès à ses fichiers sur un autre nœud.

Syntaxe

typedef struct _NETWORK_APP_INSTANCE_ECP_CONTEXT {
  USHORT Size;
  USHORT Reserved;
  GUID   AppInstanceID;
} NETWORK_APP_INSTANCE_ECP_CONTEXT, *PNETWORK_APP_INSTANCE_ECP_CONTEXT;

Membres

Size

Taille de cette structure. Ce membre est défini sur sizeof(NETWORK_APP_INSTANCE_ECP_CONTEXT).

Reserved

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

AppInstanceID

Identificateur de instance unique pour une application cliente de cluster de basculement. Il s’agit d’un GUID qui associe une application au fichier ouvert sur un nœud de cluster de basculement.

Remarques

Lorsque le basculement vers un nœud secondaire dans un cluster de serveurs se produit, une application cliente de cluster doit reprendre l’accès aux fichiers qu’elle a d’abord ouverts sur le nœud défaillant. L’infrastructure de basculement du client de cluster empêche le partage des violations pour les fichiers de l’application sur le nœud de basculement en validant son accès à ces fichiers. L’accès est accordé aux fichiers sur le nœud de basculement ayant le même identificateur de instance d’application que les fichiers ouverts sur un autre nœud avaient avant le basculement. L’identificateur instance se trouve dans une structure NETWORK_APP_INSTANCE_ECP_CONTEXT dans la liste ECP d’un fichier.

Par exemple, un pilote de filtre de système de fichiers alloue un NETWORK_APP_INSTANCE_ECP_CONTEXT avec l’application unique instance GUID. La structure de contexte est insérée dans la liste ECP d’un fichier lors de sa création ou de son ouverture. Les nœuds de cluster mettez en cache l’identificateur de instance à partir de l’ECP lors du traitement de la demande de création du système de fichiers réseau. Lors du basculement, le nœud de reprise peut faire correspondre l’application à son ensemble de fichiers ouverts et accorder l’accès.

Le NETWORK_APP_INSTANCE_ECP_CONTEXT est identifié dans un ECP_LIST par GUID_ECP_NETWORK_APP_INSTANCE. Ces identificateurs et d’autres identificateurs définis par le système sont décrits dans PcE définis par le système.

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.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Cette structure est Windows 8
En-tête ntifs.h (include Ntifs.h)

Voir aussi

ECP_LIST

IoCreateFileEx