Partager via

structure NETWORK_APP_INSTANCE_EA (ntifs.h)

  • Article

Structure d’attribut étendu (EA) pour les processus utilisant le basculement du client de cluster SMB (Server Message Block).

Syntaxe

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

Membres

AppInstanceID

GUID qui identifie une instance d’application unique ou une structure NETWORK_APP_INSTANCE_EA lorsque l’application contient également un indicateur pour CsvFlags.

CsvFlags

Indicateur facultatif : NETWORK_APP_INSTANCE_CSV_FLAGS_VALID_ONLY_IF_CSV_COORDINATOR (0x00000001)

L’indicateur NETWORK_APP_INSTANCE_CSV_FLAGS_VALID_ONLY_IF_CSV_COORDINATOR est utilisé uniquement lorsque le fichier est ouvert directement à partir de CSVFS. Cet indicateur est ignoré lorsque le fichier est ouvert à l’aide du protocole SMB. L’indicateur informe CSVFS que le fichier n’est ouvert que sur le nœud de coordination. Si une requête « open » est envoyée à CSVFS et que le nœud n’est pas coordonné, l’ouverture échoue. En outre, si le nœud de coordination est déplacé pendant l’ouverture du fichier, celui-ci est invalidé.

Remarques

Un processus peut inscrire un ID d’application CCF à l’aide de RegisterAppInstance, ce qui permet à toutes les opérations « open » du processus d’avoir le même Id d’application. Si un ID n’est pas inscrit, l’ID d’application diffère pour chaque opération.

Pour marquer des opérations d’ouverture individuelles avec un Autre Id d’application, définissez d’abord AppInstanceID sur une valeur GUID. vous pouvez ensuite ajouter SMB_CCF_APP_INSTANCE_EA_NAME à la liste des attributs étendus lors de l’appel NtCreateFile. Si l’application transmet également l’indicateur NETWORK_APP_INSTANCE_CSV_FLAGS_VALID_ONLY_IF_CSV_COORDINATOR, AppInstanceID doit être NETWORK_APP_INSTANCE_EA structure.

Exigences

Exigence Valeur
client minimum pris en charge Windows 8
serveur minimum pris en charge Windows Server 2012
d’en-tête ntifs.h