NETWORK_APP_INSTANCE_ECP_CONTEXT-Struktur (ntifs.h)

  • Artikel

Die NETWORK_APP_INSTANCE_ECP_CONTEXT-Struktur ist ein Extra Create Parameter (ECP) und enthält eine Anwendung instance Bezeichner, die einer Datei zugeordnet werden soll. Diese Struktur wird verwendet, um die Dateien zu identifizieren, die für eine Failoverclusterclientanwendung geöffnet werden, wenn diese Anwendung den Zugriff auf ihre Dateien auf einem anderen Knoten wieder aufgenommen hat.

Syntax

typedef struct _NETWORK_APP_INSTANCE_ECP_CONTEXT {
  USHORT Size;
  USHORT Reserved;
  GUID   AppInstanceID;
} NETWORK_APP_INSTANCE_ECP_CONTEXT, *PNETWORK_APP_INSTANCE_ECP_CONTEXT;

Member

Size

Größe dieser Struktur. Dieser Member ist auf sizeof(NETWORK_APP_INSTANCE_ECP_CONTEXT) festgelegt.

Reserved

Reserviert. Muss auf 0 (null) festgelegt werden.

AppInstanceID

Ein eindeutiger instance-Bezeichner für eine Failoverclusterclientanwendung. Dies ist eine GUID, die eine Anwendung einer Datei zuordnet, die auf einem Failoverclusterknoten geöffnet wurde.

Hinweise

Wenn ein Failover auf einen sekundären Knoten in einem Servercluster erfolgt, muss eine Clusterclientanwendung den Zugriff auf die Dateien fortsetzen, die sie zuerst auf dem fehlerhaften Knoten geöffnet hat. Die Clusterclientfailoverinfrastruktur verhindert die Freigabe von Verstößen für die Dateien der Anwendung auf dem Failoverknoten, indem der Zugriff auf diese Dateien überprüft wird. Der Zugriff wird den Dateien auf dem Failoverknoten gewährt, die denselben Anwendungsbezeichner instance wie die dateien, die vor dem Failover auf einem anderen Knoten geöffnet wurden. Der instance-Bezeichner befindet sich in einer NETWORK_APP_INSTANCE_ECP_CONTEXT-Struktur in der ECP-Liste einer Datei.

Beispielsweise ordnet ein Dateisystemfiltertreiber eine NETWORK_APP_INSTANCE_ECP_CONTEXT der eindeutigen Anwendung instance GUID zu. Die Kontextstruktur wird beim Erstellen oder Öffnen in die ECP-Liste einer Datei eingefügt. Die Clusterknoten speichern den instance-Bezeichner aus dem ECP zwischen, wenn die Erstellungsanforderung des Netzwerkdateisystems verarbeitet wird. Beim Failover kann der fortgesetzte Knoten die Anwendung mit ihrem Satz geöffneter Dateien abgleichen und Zugriff gewähren.

Die NETWORK_APP_INSTANCE_ECP_CONTEXT wird in einer ECP_LIST durch GUID_ECP_NETWORK_APP_INSTANCE identifiziert. Diese und andere systemdefinierte Bezeichner werden unter Systemdefinierte ECPs beschrieben.

Informationen zur Verwendung von ECPs zum Zuordnen zusätzlicher Informationen zu einer Datei beim Erstellen der Datei finden Sie unter Verwenden zusätzlicher Erstellungsparameter mit einem IRP_MJ_CREATE Vorgang.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Diese Struktur ist Windows 8
Kopfzeile ntifs.h (include Ntifs.h)

Weitere Informationen

ECP_LIST

IoCreateFileEx