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で識別されます。 この識別子とその他のシステム定義識別子については、「 システム定義 ECP」を参照してください。

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

要件

こちらもご覧ください

ECP_LIST

IoCreateFileEx