Share via

структура ECP_OPEN_PARAMETERS (ntifs.h)

  • Статья

Структура ECP_OPEN_PARAMETERS содержит дополнительные параметры создания (ECP), который позволяет вызывающей стороне указать цель открытия файла без вмешательства в существующие дескрипторы и (или) оппортунистические блокировки (блокировки) файла.

Синтаксис

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 позволяют компоненту режима ядра открываться для доступа только к метаданным, не мешая другому доступу, при этом все еще настраивается контекст шифрования для операций чтения и записи. Фильтр может задать эти флаги, чтобы избежать конфликтов с блокировкой. Настройка состояния шифрования для операций чтения и записи требует больших затрат и обычно не выполняется, если файлы не открываются для доступа на чтение и запись.

Системное значение GUID_ECP_OPEN_PARAMETERS используется с этой структурой контекста ECP при вызове связанных с ECP процедур поддержки, таких как FltAllocateExtraCreateParameter и FsRtlRemoveExtraCreateParameter.

Дополнительные сведения см. в статье Общие сведения о дополнительных параметрах создания .

Требования

Требование Значение
Минимальная версия клиента Windows 10, версия 1709.
Верхняя часть ntifs.h (включая Ntifs.h)

См. также раздел

FltAllocateExtraCreateParameterList

FltCreateFileEx2