estrutura NETWORK_APP_INSTANCE_ECP_CONTEXT (ntifs.h)

A estrutura NETWORK_APP_INSTANCE_ECP_CONTEXT é um ECP (Parâmetro de Criação Extra) e contém um identificador de instância de aplicativo a ser associado a um arquivo. Essa estrutura é usada para identificar os arquivos abertos para um aplicativo cliente de cluster de failover quando esse aplicativo retoma o acesso aos arquivos em outro nó.

Sintaxe

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

Membros

Size

Tamanho dessa estrutura. Esse membro é definido como sizeof(NETWORK_APP_INSTANCE_ECP_CONTEXT).

Reserved

Reservado. Deve ser definido como zero.

AppInstanceID

Um identificador de instância exclusivo para um aplicativo cliente de cluster de failover. Esse é um GUID que associa um aplicativo ao arquivo aberto em um nó de cluster de failover.

Comentários

Quando ocorre o failover para um nó secundário em um cluster de servidor, um aplicativo cliente de cluster precisa retomar o acesso aos arquivos abertos pela primeira vez no nó com falha. A infraestrutura de Failover do Cliente de Cluster impede o compartilhamento de violações dos arquivos do aplicativo no nó de failover validando seu acesso a esses arquivos. O acesso é concedido aos arquivos que no nó de failover tem o mesmo identificador de instância de aplicativo que os arquivos abertos em outro nó tinham antes do failover. O identificador de instância é encontrado em uma estrutura NETWORK_APP_INSTANCE_ECP_CONTEXT na lista ECP de um arquivo.

Por exemplo, um driver de filtro do sistema de arquivos alocará um NETWORK_APP_INSTANCE_ECP_CONTEXT com o GUID de instância de aplicativo exclusivo. A estrutura de contexto é inserida na lista ECP de um arquivo quando ele é criado ou aberto. Os nós de cluster armazenam em cache o identificador de instância do ECP ao processar a solicitação de criação do sistema de arquivos de rede. No failover, o nó de retomada pode corresponder o aplicativo ao conjunto de arquivos abertos e conceder acesso.

O NETWORK_APP_INSTANCE_ECP_CONTEXT é identificado em um ECP_LIST por GUID_ECP_NETWORK_APP_INSTANCE. Esse e outros identificadores definidos pelo sistema são descritos em ECPs definidos pelo sistema.

Para obter informações sobre como usar ECPs para associar informações extras a um arquivo quando o arquivo é criado, consulte Usando parâmetros de criação extra com uma operação de IRP_MJ_CREATE.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Essa estrutura é Windows 8
Cabeçalho	ntifs.h (inclua Ntifs.h)

Confira também

ECP_LIST

IoCreateFileEx