ECP_OPEN_PARAMETERS結構 (ntifs.h)

  • 發行項

ECP_OPEN_PARAMETERS 結構包含 ECP) 內容 (額外的建立參數，可讓呼叫者指定開啟檔案的目的，而不會干擾檔案的現有句柄和/或商機鎖定， (檔案上的 oplocks) 。

語法

typedef struct _ECP_OPEN_PARAMETERS {
  USHORT Size;
  USHORT Reserved;
  ULONG  Flags;
} ECP_OPEN_PARAMETERS, *PECP_OPEN_PARAMETERS;

成員

Size

指定此內容結構的大小，以位元組為單位。

Reserved

保留供未來使用。 這必須初始化為 0。

Flags

指定開啟檔案之參數或用途的旗標。 旗標 可以是下列值的任何組合：

值 Description
ECP_OPEN_PARAMETERS_FLAG_OPEN_FOR_READ (0x0001) 開啟檔案以讀取它。
ECP_OPEN_PARAMETERS_FLAG_OPEN_FOR_WRITE (0x0002) 開啟檔案以寫入檔案。
ECP_OPEN_PARAMETERS_FLAG_OPEN_FOR_DELETE (0x0004) 開啟檔案加以刪除。
ECP_OPEN_PARAMETERS_FLAG_IGNORE_DIR_CASE_SENSITIVITY (0x0008) 強制開啟此檔案的不區分大小寫查閱，即使在區分大小寫的目錄下亦然。 從 Windows 10 版本 2004 開始提供。
ECP_OPEN_PARAMETERS_FLAG_FAIL_ON_CASE_SENSITIVE_DIR ( 0x0010) 如果路徑有任何區分大小寫的目錄，則檔案開啟或建立要求失敗。 從 Windows 10 版本 2004 開始提供。

備註

ECP_OPEN_PARAMETERS_FLAG_OPEN_FOR_READ和ECP_OPEN_PARAMETERS_FLAG_OPEN_FOR_WRITE旗標允許加密檔案的讀取/寫入存取權，而不需要實際開啟這類檔案以進行讀取/寫入存取。 這些 ECP 旗標可讓內核模式元件針對僅限元數據的存取開啟，因此不會干擾其他存取，同時仍取得加密內容設定以執行讀取/寫入。 篩選可以設定這些旗標，以避免與鎖定衝突。 設定讀取/寫入作業的加密狀態很昂貴，而且通常不會在檔案未開啟以進行讀取/寫入存取時完成。

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

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

規格需求

需求 值
最低支援的用戶端 Windows 10 1709 版。
標頭 ntifs.h (包含 Ntifs.h)

另請參閱

FltAllocateExtraCreateParameterList

FltCreateFileEx2