структура 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) |