Partager via


structure NETWORK_APP_INSTANCE_ECP_CONTEXT (ntifs.h)

La structure NETWORK_APP_INSTANCE_ECP_CONTEXT est un paramètre de création supplémentaire (ECP) et contient un identificateur d’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 taille de(NETWORK_APP_INSTANCE_ECP_CONTEXT).

Reserved

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

AppInstanceID

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

Remarques

Lors du basculement vers un nœud secondaire dans un cluster de serveurs, une application cliente de cluster doit reprendre l’accès aux fichiers qu’elle a d’abord ouverts sur le nœud ayant échoué. L’infrastructure de basculement du client de cluster empêche le partage des violations des 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 d’instance d’application que les fichiers ouverts sur d’autres nœuds avant le basculement. L’identificateur d’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 le GUID d’instance d’application unique. La structure de contexte est insérée dans la liste ECP d’un fichier lorsqu’il est créé ou ouvert. Les nœuds de cluster cachent l’identificateur d’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 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 autres identificateurs définis par le système sont décrits dans System-Defined.

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.

Exigences

Exigence Valeur
client minimum pris en charge Cette structure est Windows 8
d’en-tête ntifs.h (include Ntifs.h)

Voir aussi

ECP_LIST

ioCreateFileEx