NETWORK_APP_INSTANCE_EA Struktur (ntifs.h)

Eine EA-Struktur (Extended Attribute) für Prozesse, die SMB-Clusterfailover (Server Message Block) verwenden.

Syntax

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

Member

AppInstanceID

Eine GUID, die eine einzelne Anwendung instance identifiziert, oder eine NETWORK_APP_INSTANCE_EA-Struktur, wenn die Anwendung zusätzlich ein Flag für CsvFlags enthält.

CsvFlags

Ein optionales Flag: NETWORK_APP_INSTANCE_CSV_FLAGS_VALID_ONLY_IF_CSV_COORDINATOR (0x00000001)

Das NETWORK_APP_INSTANCE_CSV_FLAGS_VALID_ONLY_IF_CSV_COORDINATOR-Flag wird nur verwendet, wenn die Datei direkt aus CSVFS geöffnet wird. Dieses Flag wird ignoriert, wenn die Datei mit dem SMB-Protokoll geöffnet wird. Das Flag benachrichtigt CSVFS, dass die Datei nur auf dem koordinierenden Knoten geöffnet wird. Wenn eine "offene" Anforderung an CSVFS gesendet wird und der Knoten nicht koordiniert ist, tritt beim Öffnen ein Fehler auf. Wenn außerdem der koordinierende Knoten verschoben wird, während die Datei geöffnet wird, wird die geöffnete Datei ungültig.

Hinweise

Ein Prozess kann eine CCF-Anwendungs-ID mithilfe von RegisterAppInstance registrieren, sodass alle "offenen" Vorgänge aus dem Prozess dieselbe ApplicationId aufweisen. Wenn eine ID nicht registriert ist, unterscheidet sich die ApplicationId für jeden Vorgang.

Um einzelne geöffnete Vorgänge mit einer anderen ApplicationId zu markieren, legen Sie Zuerst AppInstanceID auf einen GUID-Wert fest. Sie können dann SMB_CCF_APP_INSTANCE_EA_NAME an die Liste der erweiterten Attribute anfügen, wenn Sie NtCreateFile aufrufen. Wenn die Anwendung auch das NETWORK_APP_INSTANCE_CSV_FLAGS_VALID_ONLY_IF_CSV_COORDINATOR-Flag übergibt, sollte AppInstanceIDNETWORK_APP_INSTANCE_EA Struktur sein.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8
Unterstützte Mindestversion (Server)	Windows Server 2012
Kopfzeile	ntifs.h