NETWORK_APP_INSTANCE_ECP_CONTEXT結構 （ntifs.h）

NETWORK_APP_INSTANCE_ECP_CONTEXT 結構是額外的建立參數 （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

保留。 必須設定為零。

AppInstanceID

故障轉移叢集用戶端應用程式的唯一實例標識碼。 這是 GUID，可將應用程式與故障轉移叢集節點上開啟的檔案產生關聯。

言論

當故障轉移至伺服器叢集中的次要節點時，叢集用戶端應用程式需要繼續存取它第一次在失敗節點上開啟的檔案。 叢集用戶端故障轉移基礎結構藉由驗證應用程式對這些檔案的存取權，防止共用故障轉移節點上應用程式的檔案違規。 存取權會授與故障轉移節點上的檔案，其應用程式實例標識碼與故障轉移前在其他節點上開啟的檔案具有相同的應用程式實例標識碼。 實例標識碼位於檔案ECP清單中的 NETWORK_APP_INSTANCE_ECP_CONTEXT 結構中。

例如，檔案系統篩選驅動程式會配置具有唯一應用程式實例 GUID 的 NETWORK_APP_INSTANCE_ECP_CONTEXT。 建立或開啟檔案時，內容結構會插入檔案的ECP清單中。 叢集節點會在處理網路文件系統建立要求時，從 ECP 快取實例識別碼。 在故障轉移時，繼續節點可以比對應用程式與其開啟的檔案集，並授與存取權。

GUID_ECP_NETWORK_APP_INSTANCE在 ECP_LIST 中識別 NETWORK_APP_INSTANCE_ECP_CONTEXT。 這和其他系統定義的標識碼會在System-Defined ECP 中描述。

如需有關如何在建立檔案時使用 ECP 將額外資訊與檔案產生關聯的資訊，請參閱 搭配使用額外建立參數搭配IRP_MJ_CREATE作業。

要求

另請參閱

ECP_LIST

IoCreateFileEx