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
指定開啟檔案之參數或用途的旗標。 旗標 可以是下列值的任何組合:
價值 | 描述 |
---|---|
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 旗標可讓內核模式元件針對僅限元數據的存取開啟,因此不會干擾其他存取,同時仍會取得加密內容設定以執行讀取/寫入。 篩選可以設定這些旗標,以避免與鎖定衝突。 設定讀取/寫入作業的加密狀態很昂貴,而且通常不會在檔案未開啟以進行讀取/寫入存取時完成。
呼叫與 ECP 相關的支援例程時,系統定義的GUID_ECP_OPEN_PARAMETERS值會與這個 ECP 內容結構搭配使用,例如 FltAllocateExtraCreateParameter 和 FsRtlRemoveExtraCreateParameter。
如需詳細資訊,請參閱 額外建立參數 簡介。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | Windows 10 版本 1709。 |
標頭 | ntifs.h (include Ntifs.h) |