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) |