NETWORK_APP_INSTANCE_ECP_CONTEXT Struktur (ntifs.h)
Die NETWORK_APP_INSTANCE_ECP_CONTEXT Struktur ist ein extra Create Parameter (ECP) und enthält einen Anwendungsinstanzbezeichner, der einer Datei zugeordnet werden soll. Diese Struktur wird verwendet, um die Dateien zu identifizieren, die für eine Failoverclusterclientanwendung geöffnet wurden, wenn diese Anwendung den Zugriff auf seine Dateien auf einem anderen Knoten forthält.
Syntax
typedef struct _NETWORK_APP_INSTANCE_ECP_CONTEXT {
USHORT Size;
USHORT Reserved;
GUID AppInstanceID;
} NETWORK_APP_INSTANCE_ECP_CONTEXT, *PNETWORK_APP_INSTANCE_ECP_CONTEXT;
Angehörige
Size
Größe dieser Struktur. Dieses Element ist auf Größe(NETWORK_APP_INSTANCE_ECP_CONTEXT) festgelegt.
Reserved
Reserviert. Muss auf Null festgelegt werden.
AppInstanceID
Ein eindeutiger Instanzbezeichner für eine Failoverclusterclientanwendung. Dies ist eine GUID, die eine Anwendung einer Datei zuordnet, die auf einem Failoverclusterknoten geöffnet wird.
Bemerkungen
Wenn ein Failover auf einen sekundären Knoten in einem Servercluster auftritt, benötigt eine Clusterclientanwendung den fortgesetzten Zugriff auf die Dateien, die sie zuerst auf dem fehlgeschlagenen Knoten geöffnet hat. Die Clusterclient-Failoverinfrastruktur verhindert Die Freigabeverletzungen für die Dateien der Anwendung auf dem Failoverknoten, indem der Zugriff auf diese Dateien überprüft wird. Der Zugriff wird den Dateien gewährt, die auf dem Failoverknoten denselben Anwendungsinstanzbezeichner aufweisen wie die Dateien, die auf einem anderen Knoten geöffnet wurden, vor dem Failover hatten. Der Instanzbezeichner befindet sich in einer NETWORK_APP_INSTANCE_ECP_CONTEXT Struktur in der ECP-Liste einer Datei.
Beispielsweise weist ein Dateisystemfiltertreiber eine NETWORK_APP_INSTANCE_ECP_CONTEXT mit der eindeutigen Anwendungsinstanz-GUID zu. Die Kontextstruktur wird beim Erstellen oder Öffnen in die ECP-Liste einer Datei eingefügt. Die Clusterknoten speichern den Instanzbezeichner aus dem ECP beim Verarbeiten der Erstellungsanforderung des Netzwerkdateisystems zwischen. Beim Failover kann der Fortsetzungsknoten der Anwendung mit seiner Gruppe geöffneter Dateien übereinstimmen und Zugriff gewähren.
Die NETWORK_APP_INSTANCE_ECP_CONTEXT wird in einer ECP_LIST durch GUID_ECP_NETWORK_APP_INSTANCEidentifiziert. Diese und andere systemdefinierte Bezeichner werden in System-Defined ECPsbeschrieben.
Informationen zur Verwendung von ECPs zum Zuordnen zusätzlicher Informationen zu einer Datei beim Erstellen der Datei finden Sie unter Verwenden von zusätzlichen Erstellungsparametern mit einem IRP_MJ_CREATE Operation.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Diese Struktur ist Windows 8 |
| Header- | ntifs.h (einschließlich Ntifs.h) |