структура 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 (include Ntifs.h) |