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 de 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 avertit 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, le fichier ouvert est invalidé.

Remarques

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

Pour marquer des opérations ouvertes individuelles avec un Autre ApplicationId, 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 de NtCreateFile. Si l’application passe également l’indicateur NETWORK_APP_INSTANCE_CSV_FLAGS_VALID_ONLY_IF_CSV_COORDINATOR , AppInstanceID doit être NETWORK_APP_INSTANCE_EA structure.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 8
Serveur minimal pris en charge Windows Server 2012
En-tête ntifs.h