struttura NETWORK_APP_INSTANCE_ECP_CONTEXT (ntifs.h)

  • Articolo

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 l'applicazione riprende l'accesso ai 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;

Members

Size

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

Reserved

Riservato. Deve essere impostato su zero.

AppInstanceID

Identificatore di istanza univoco 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.

Commenti

Quando si verifica il failover in un nodo secondario in un cluster di 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 di 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 univoco dell'istanza dell'applicazione. La struttura di contesto viene inserita nell'elenco ECP di un file al momento della creazione o dell'apertura. I nodi del cluster memorizzano nella cache l'identificatore dell'istanza da 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 ECP definiti dal sistema.

Per informazioni su come usare gli ecp per associare informazioni aggiuntive a un file al momento della creazione del file, vedere Using Extra Create Parameters with an IRP_MJ_CREATE Operation .For information about how to use ECPs to associate extra information with a file when the file is created, see Using Extra Create Parameters with an IRP_MJ_CREATE Operation.

Requisiti

Requisito Valore
Client minimo supportato Questa struttura è Windows 8
Intestazione ntifs.h (include Ntifs.h)

Vedi anche

ECP_LIST

IoCreateFileEx