CSV_SET_HANDLE_PROPERTIES_ECP_CONTEXT結構 (ntifs.h)

CSV_SET_HANDLE_PROPERTIES_ECP_CONTEXT 結構包含額外的 create 參數 (ECP) 內容，可傳送至叢集共用磁碟區 (CSV) 檔案系統，以設定處理 IO 抵達此開啟方式的屬性。

語法

typedef struct _CSV_SET_HANDLE_PROPERTIES_ECP_CONTEXT {
  SIZE_T Size;
  ULONG  PauseTimeoutInSeconds;
  ULONG  Flags;
} CSV_SET_HANDLE_PROPERTIES_ECP_CONTEXT, *PCSV_SET_HANDLE_PROPERTIES_ECP_CONTEXT;

成員

Size

這個 結構的大小，以位元組為單位。

PauseTimeoutInSeconds

當 CSV 磁碟區暫停時，允許 CSVFS 保留在此檔案對象上發出之 IO 的秒數。 一旦到期，CSV 就會完成此檔案對象上發出且狀態為STATUS_CSV_IO_PAUSE_TIMEOUT的所有 IO。 這個成員可以是下列其中一個值。

值	意義
0xFFFFFFFF	表示沒有逾時，並要求預設行為。
0	CSV 不會暫停 IO，而且會立即完成 IO。
任何其他值	CSV 會將所有其他值四捨五入為 10 秒的倍數，並使用此值作為逾時。 支援的逾時值上限為 30 分鐘。 如果提供的值大於 30 分鐘，CSV 會以無訊息方式將值設定為最大值。

Flags

set 屬性旗標。 這個成員可以是下列旗標的位 OR。

旗標	意義
CSV_SET_HANDLE_PROPERTIES_ECP_CONTEXT_FLAGS_VALID_ONLY_IF_CSV_COORDINATOR	告知 CSVFS 此檔案開啟應該只在協調節點上有效。 如果開啟是 CSVFS，而且節點不是協調節點，則開啟將會失敗。 如果檔案已開啟且協調節點已移動，則開啟的檔案將會失效。 只有在檔案直接在 CSVFS 上開啟時，才會使用此旗標，並在透過 SMB 開啟檔案時予以忽略。

旗標的下層 16 位適用於會導致 建立失敗的旗標，如果 CSV 無法辨識這些旗標，則STATUS_INVALID_PARAMETER。 如果 CSVFS 不知道如何處理它們，則上限 16 位適用於會以無訊息方式忽略的旗標。

備註

呼叫 FLtAllocateExtraCreateParameter 和 FsRtlRemoveExtraCreateParameter 等 ECP 相關支援例程時，系統定義的GUID_ECP_CSV_SET_HANDLE_PROPERTIES值會與這個 ECP 內容結構搭配使用。

如需詳細資訊 ，請參閱額外建立參數簡介 。

規格需求

需求	值
最低支援的用戶端	Windows 8
標頭	ntifs.h