struttura NETWORK_APP_INSTANCE_ECP_CONTEXT (ntifs.h)

La struttura NETWORK_APP_INSTANCE_ECP_CONTEXT è un parametro ECP (Extra Create Parameter) e contiene un identificatore di istanza dell'applicazione da associare a un file. Questa struttura viene usata per identificare i file aperti per un'applicazione client del cluster di failover quando tale applicazione riprende l'accesso ai relativi file in un altro nodo.

Sintassi

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

Membri

Size

Dimensioni di questa struttura. Questo membro è impostato su sizeof(NETWORK_APP_INSTANCE_ECP_CONTEXT).

Reserved

Riservato. Deve essere impostato su zero.

AppInstanceID

Identificatore univoco dell'istanza per un'applicazione client del cluster di failover. Si tratta di un GUID che associa un'applicazione al file aperto in un nodo del cluster di failover.

Osservazioni

Quando si verifica il failover in un nodo secondario in un cluster server, un'applicazione client del cluster deve riprendere l'accesso ai file aperti per la prima volta nel nodo non riuscito. L'infrastruttura di failover client del cluster impedisce violazioni di condivisione per i file dell'applicazione nel nodo di failover convalidandone l'accesso a tali file. L'accesso viene concesso ai file nel nodo di failover con lo stesso identificatore dell'istanza dell'applicazione dei file aperti in un altro nodo prima del failover. L'identificatore dell'istanza si trova in una struttura NETWORK_APP_INSTANCE_ECP_CONTEXT nell'elenco ECP di un file.

Ad esempio, un driver di filtro del file system allocherà un NETWORK_APP_INSTANCE_ECP_CONTEXT con il GUID dell'istanza dell'applicazione univoca. La struttura di contesto viene inserita nell'elenco ECP di un file quando viene creata o aperta. I nodi del cluster memorizzano nella cache l'identificatore dell'istanza di ECP durante l'elaborazione della richiesta di creazione del file system di rete. In caso di failover, il nodo di ripresa può corrispondere all'applicazione al set di file aperti e concedere l'accesso.

Il NETWORK_APP_INSTANCE_ECP_CONTEXT viene identificato in un ECP_LIST da GUID_ECP_NETWORK_APP_INSTANCE. Questo e altri identificatori definiti dal sistema sono descritti in System-Defined ECP.

Per informazioni su come usare gli ECP per associare informazioni aggiuntive a un file quando viene creato il file, vedere Using Extra Create Parameters with an IRP_MJ_CREATE Operation.For information about how to use ECP to associate extra information with a file when the file is created, see Using Extra Create Parameters with an IRP_MJ_CREATE Operation.

Fabbisogno

Vedere anche

ECP_LIST

IoCreateFileEx