NETWORK_APP_INSTANCE_EA 結構 (ntifs.h)

  • 發行項

使用伺服器消息塊 (SMB) 叢集用戶端故障轉移之進程的擴充屬性 (EA) 結構。

語法

typedef struct _NETWORK_APP_INSTANCE_EA {
  GUID  AppInstanceID;
  ULONG CsvFlags;
} NETWORK_APP_INSTANCE_EA, *PNETWORK_APP_INSTANCE_EA;

成員

AppInstanceID

識別單一應用程式實例的 GUID，或應用程式額外包含 CsvFlags 旗標時的NETWORK_APP_INSTANCE_EA結構。

CsvFlags

選擇性旗標： NETWORK_APP_INSTANCE_CSV_FLAGS_VALID_ONLY_IF_CSV_COORDINATOR (0x00000001)

只有在檔案直接從 CSVFS 開啟時，才會使用 NETWORK_APP_INSTANCE_CSV_FLAGS_VALID_ONLY_IF_CSV_COORDINATOR 旗標。 使用SMB通訊協議開啟檔案時，會忽略此旗標。 旗標會通知 CSVFS，檔案只在協調節點上開啟。 如果「開啟」要求傳送至 CSVFS，且節點未協調，則開啟將會失敗。 此外，如果在開啟檔案時移動協調節點，則開啟的檔案將會失效。

備註

進程可以使用 RegisterAppInstance 註冊 CCF 應用程式識別碼，讓進程的所有「開啟」作業都具有相同的 ApplicationId。 如果未註冊標識碼，則每個作業的 ApplicationId 將會有所不同。

若要使用不同的 ApplicationId 標記個別開啟的作業，請先將 AppInstanceID 設定為 GUID 值。 接著，您可以在呼叫 NtCreateFile 時，將SMB_CCF_APP_INSTANCE_EA_NAME附加至擴充屬性清單。 如果應用程式也傳遞 NETWORK_APP_INSTANCE_CSV_FLAGS_VALID_ONLY_IF_CSV_COORDINATOR 旗標， 則 AppInstanceID 應該 NETWORK_APP_INSTANCE_EA 結構。

規格需求

需求 值
最低支援的用戶端 Windows 8
最低支援的伺服器 Windows Server 2012
標頭 ntifs.h