estrutura NETWORK_APP_INSTANCE_EA (ntifs.h)

Uma estrutura de Atributo Estendido (EA) para processos usando failover de cliente de cluster SMB (Server Message Block).

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 adicionalmente 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.

Observações

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 para 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