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。 這和其他系統定義的標識碼會在 系統定義的 ECP 中說明。

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

規格需求

需求 值
最低支援的用戶端 此結構 Windows 8
標頭 ntifs.h (包含 Ntifs.h)

另請參閱

ECP_LIST

IoCreateFileEx