NETWORK_APP_INSTANCE_ECP_CONTEXT構造体 (ntifs.h)

NETWORK_APP_INSTANCE_ECP_CONTEXT 構造体は Extra Create Parameter (ECP) であり、ファイルに関連付けるアプリケーション インスタンス識別子が含まれています。 この構造は、そのアプリケーションが別のノード上のファイルへのアクセスを再開するときに、フェールオーバー クラスター クライアント アプリケーション用に開かれたファイルを識別するために使用されます。

構文

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

メンバーズ

Size

この構造体のサイズ。 このメンバーは、sizeof(NETWORK_APP_INSTANCE_ECP_CONTEXT) を に設定されます。

Reserved

引っ込み思案。 0 に設定する必要があります。

AppInstanceID

フェールオーバー クラスター クライアント アプリケーションの一意のインスタンス識別子。 これは、フェールオーバー クラスター ノードで開かれたファイルにアプリケーションを関連付ける GUID です。

備考

サーバー クラスター内のセカンダリ ノードへのフェールオーバーが発生した場合、クラスター クライアント アプリケーションは、障害が発生したノードで最初に開いたファイルへのアクセスを再開する必要があります。 クラスター クライアント フェールオーバー インフラストラクチャは、これらのファイルへのアクセスを検証することで、フェールオーバー ノード上のアプリケーションのファイルの共有違反を防ぎます。 フェールオーバー前に他のノードで開かれたファイルと同じアプリケーション インスタンス識別子を持つフェールオーバー ノード上のファイルへのアクセス権が付与されます。 インスタンス識別子は、ファイルの ECP リストの NETWORK_APP_INSTANCE_ECP_CONTEXT 構造体にあります。

たとえば、ファイル システム フィルター ドライバーは、一意のアプリケーション インスタンス GUID を持つ NETWORK_APP_INSTANCE_ECP_CONTEXT を割り当てます。 コンテキスト構造は、ファイルの作成時またはオープン時にファイルの ECP リストに挿入されます。 クラスター ノードは、ネットワーク ファイル システムの作成要求を処理するときに、ECP のインスタンス識別子をキャッシュします。 フェールオーバー時に、再開ノードはアプリケーションを開いている一連のファイルと一致させ、アクセス権を付与できます。

NETWORK_APP_INSTANCE_ECP_CONTEXT は、GUID_ECP_NETWORK_APP_INSTANCEによって ECP_LIST で識別されます。 この識別子とその他のシステム定義識別子については、System-Defined ECPで説明されています。

ファイルの作成時に ECP を使用して追加情報をファイルに関連付ける方法については、「IRP_MJ_CREATE操作で追加の作成パラメーターを使用する 」を参照してください。

必要条件

関連項目

ECP_LIST

IoCreateFileEx の