estrutura NETWORK_APP_INSTANCE_EA (ntifs.h)

Uma estrutura de EA (Atributo Estendido) para processos que usam o Failover de Cliente de Cluster SMB (Bloco de Mensagens do Servidor).

Sintaxe

typedef struct _NETWORK_APP_INSTANCE_EA {
  GUID  AppInstanceID;
  ULONG CsvFlags;
} NETWORK_APP_INSTANCE_EA, *PNETWORK_APP_INSTANCE_EA;

Membros

AppInstanceID

Um GUID que identifica uma única instância de aplicativo ou uma estrutura NETWORK_APP_INSTANCE_EA quando o aplicativo contém, além disso, um sinalizador para CsvFlags.

CsvFlags

Um sinalizador opcional: NETWORK_APP_INSTANCE_CSV_FLAGS_VALID_ONLY_IF_CSV_COORDINATOR (0x00000001)

O sinalizador NETWORK_APP_INSTANCE_CSV_FLAGS_VALID_ONLY_IF_CSV_COORDINATOR só é usado quando o arquivo é aberto diretamente do CSVFS. Esse sinalizador é ignorado quando o arquivo é aberto usando o protocolo SMB. O sinalizador notifica o CSVFS de que o arquivo só será aberto no nó de coordenação. Se uma solicitação 'open' for enviada ao CSVFS e o nó não estiver coordenando, a abertura falhará. Além disso, se o nó de coordenação for movido enquanto o arquivo for aberto, o arquivo aberto será invalidado.

Comentários

Um processo pode registrar uma ID de aplicativo CCF usando RegisterAppInstance, permitindo que todas as operações "abertas" do processo tenham a mesma ApplicationId. Se uma ID não estiver registrada, a ApplicationId será diferente para cada operação.

Para marcar operações abertas individuais com uma ApplicationId diferente, primeiro defina AppInstanceID como um valor guid. Em seguida, você pode acrescentar SMB_CCF_APP_INSTANCE_EA_NAME à lista de Atributos Estendidos ao chamar NtCreateFile. Se o aplicativo também passar o sinalizador NETWORK_APP_INSTANCE_CSV_FLAGS_VALID_ONLY_IF_CSV_COORDINATOR , AppInstanceID deverá ser NETWORK_APP_INSTANCE_EA estrutura.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 8
Servidor mínimo com suporte Windows Server 2012
Cabeçalho ntifs.h