共用方式為


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 內容結構搭配使用,例如 FltAllocateExtraCreateParameterFsRtlRemoveExtraCreateParameter

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

要求

要求 價值
最低支援的用戶端 Windows 10 版本 1709。
標頭 ntifs.h (include Ntifs.h)

另請參閱

FltAllocateExtraCreateParameterList

FltCreateFileEx2