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 seus 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 está definido como tamanhos de(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.
Observações
Quando ocorre failover para um nó secundário em um cluster de servidor, um aplicativo cliente de cluster precisa de acesso retomado aos arquivos que ele abriu primeiro no nó com falha. A infraestrutura de failover do cliente de cluster impede o compartilhamento de violações para os arquivos do aplicativo no nó de failover validando seu acesso a esses arquivos. O acesso é concedido aos arquivos no nó de failover que 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 System-Definedde ECPs.
Para obter informações sobre como usar ECPs para associar informações extras a um arquivo quando o arquivo for criado, consulte Usando parâmetros de criação extra com uma operação IRP_MJ_CREATE.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Essa estrutura é o Windows 8 |
| cabeçalho | ntifs.h (inclua Ntifs.h) |