структура CREATEFILE2_EXTENDED_PARAMETERS (fileapi.h)

Содержит необязательные расширенные параметры для CreateFile2.

Синтаксис

typedef struct _CREATEFILE2_EXTENDED_PARAMETERS {
  DWORD                 dwSize;
  DWORD                 dwFileAttributes;
  DWORD                 dwFileFlags;
  DWORD                 dwSecurityQosFlags;
  LPSECURITY_ATTRIBUTES lpSecurityAttributes;
  HANDLE                hTemplateFile;
} CREATEFILE2_EXTENDED_PARAMETERS, *PCREATEFILE2_EXTENDED_PARAMETERS, *LPCREATEFILE2_EXTENDED_PARAMETERS;

Члены

dwSize

Содержит размер этой структуры , sizeof(CREATEFILE2_EXTENDED_PARAMETERS).

dwFileAttributes

Атрибуты и флаги файла или устройства , FILE_ATTRIBUTE_NORMAL являются наиболее распространенным значением по умолчанию для файлов.

Этот параметр может включать любое сочетание доступных атрибутов файла (FILE_ATTRIBUTE_*). Все остальные атрибуты файла переопределяют FILE_ATTRIBUTE_NORMAL.

Некоторые из следующих атрибутов и флагов файлов могут применяться только к файлам, а не ко всем другим типам устройств, которые может открывать CreateFile2 . Дополнительные сведения см. в разделе Примечания страницы справочника CreateFile2 и в разделе Создание и открытие файлов.

Дополнительные сведения о расширенном доступе к атрибутам файлов см. в разделе SetFileAttributes. Полный список всех атрибутов файла с их значениями и описаниями см. в разделе File Attribute Constants.

dwFileFlags

Этот параметр может содержать сочетания флагов (FILE_FLAG_*) для управления поведением кэширования файлов или устройств, режимов доступа и других специальных флагов.

dwSecurityQosFlags

Параметр dwSecurityQosFlags указывает сведения о SQOS. Дополнительные сведения см. в разделе Уровни олицетворения.

lpSecurityAttributes

Указатель на структуру SECURITY_ATTRIBUTES , содержащую два отдельных, но связанных элемента данных: необязательный дескриптор безопасности и логическое значение, определяющее, может ли возвращаемый дескриптор наследоваться дочерними процессами.

Этот параметр может принимать значение NULL.

Если этот параметр имеет значение NULL, дескриптор, возвращаемый CreateFile2 , не может быть унаследован никакими дочерними процессами, которые может создать приложение, и файл или устройство, связанное с возвращенным дескриптором, получает дескриптор безопасности по умолчанию.

Элемент lpSecurityDescriptor структуры задает SECURITY_DESCRIPTOR для файла или устройства. Если этот элемент имеет значение NULL, файлу или устройству, связанным с возвращенным дескриптором, назначается дескриптор безопасности по умолчанию.

CreateFile2 игнорирует элемент lpSecurityDescriptor при открытии существующего файла или устройства, но продолжает использовать элемент bInheritHandle .

Член структуры bInheritHandle указывает, можно ли наследовать возвращенный дескриптор.

Дополнительные сведения см. в разделе Примечания раздела CreateFile2 .

hTemplateFile

Допустимый дескриптор файла шаблона с правом доступа GENERIC_READ . Файл шаблона предоставляет атрибуты файла и расширенные атрибуты для создаваемого файла.

Этот параметр может принимать значение NULL.

При открытии существующего файла CreateFile2 игнорирует этот параметр.

При открытии нового зашифрованного файла файл наследует список управления доступом на уровне пользователей из родительского каталога. Дополнительные сведения см. в разделе Шифрование файлов.

Комментарии

Чтобы скомпилировать приложение, использующее структуру CREATEFILE2_EXTENDED_PARAMETERS , определите макрос _WIN32_WINNT как 0x0602 или более поздней версии. Дополнительные сведения см. в разделе Использование заголовков Windows.

Режим кэширования

Некоторые из возможных значений элемента dwFileFlags используются для управления или влияния на то, как данные, связанные с дескриптором, кэшируются системой. К ним относятся:

• FILE_FLAG_NO_BUFFERING
• FILE_FLAG_RANDOM_ACCESS
• FILE_FLAG_SEQUENTIAL_SCAN
• FILE_FLAG_WRITE_THROUGH
• FILE_ATTRIBUTE_TEMPORARY

Если ни один из этих флагов не указан, система использует схему кэширования общего назначения по умолчанию. В противном случае системное кэширование будет работать так, как указано для каждого флага.

Некоторые из этих флагов не следует объединять. Например, объединение FILE_FLAG_RANDOM_ACCESS с FILE_FLAG_SEQUENTIAL_SCAN является саморазумным.

Указание флага FILE_FLAG_SEQUENTIAL_SCAN может повысить производительность приложений, которые считывают большие файлы с помощью последовательного доступа. Повышение производительности может быть еще более заметным для приложений, которые считывают большие файлы в основном последовательно, но иногда пропускают вперед в небольших диапазонах байтов. Если приложение перемещает указатель на файл для произвольного доступа, оптимальная производительность кэширования, скорее всего, не будет. Тем не менее, правильная операция по-прежнему гарантируется.

Флаги FILE_FLAG_WRITE_THROUGH и FILE_FLAG_NO_BUFFERING являются независимыми и могут быть объединены.

Если используется FILE_FLAG_WRITE_THROUGH , но FILE_FLAG_NO_BUFFERING также не указан, поэтому системное кэширование действует, данные записываются в системный кэш, но сбрасываются на диск без задержки.

Если указаны FILE_FLAG_WRITE_THROUGH и FILE_FLAG_NO_BUFFERING , чтобы системное кэширование не действовало, данные немедленно сбрасываются на диск, не проходя через системный кэш Windows. Операционная система также запрашивает запись локального аппаратного кэша жесткого диска на постоянный носитель.

Правильное использование флага FILE_FLAG_NO_BUFFERING требует особых рекомендаций по приложениям. Дополнительные сведения см. в разделе Буферизация файлов.

Запрос на запись через FILE_FLAG_WRITE_THROUGH также приводит к тому, что NTFS очищает любые изменения метаданных, такие как обновление метки времени или операция переименования, которые возникают в результате обработки запроса. По этой причине флаг FILE_FLAG_WRITE_THROUGH часто используется вместе с флагом FILE_FLAG_NO_BUFFERING в качестве замены для вызова функции FlushFileBuffers после каждой записи, что может привести к ненужным ограничениям производительности. Использование этих флагов вместе позволяет избежать этих штрафов. Общие сведения о кэшировании файлов и метаданных см. в разделе Кэширование файлов.

При сочетании FILE_FLAG_NO_BUFFERING с FILE_FLAG_OVERLAPPED флаги обеспечивают максимальную асинхронную производительность, так как операции ввода-вывода не зависят от синхронных операций диспетчера памяти. Однако некоторые операции ввода-вывода занимают больше времени, так как данные не хранятся в кэше. Кроме того, метаданные файла могут по-прежнему кэшироваться (например, при создании пустого файла). Чтобы обеспечить очистку метаданных на диск, используйте функцию FlushFileBuffers .

Указание атрибута FILE_ATTRIBUTE_TEMPORARY приводит к тому, что файловые системы не будут записывать данные обратно в массовое хранилище, если доступно достаточно памяти кэша, так как приложение удаляет временный файл после закрытия дескриптора. В этом случае система может полностью избежать записи данных. Хотя он напрямую не управляет кэшированием данных так же, как упомянутые ранее флаги, атрибут FILE_ATTRIBUTE_TEMPORARY указывает системе хранить как можно больше данных в системном кэше без записи и, следовательно, может быть проблемой для некоторых приложений.

Синхронные и асинхронные дескрипторы ввода-вывода

CreateFile2 позволяет создать дескриптор файла или устройства, который является синхронным или асинхронным. Синхронный дескриптор ведет себя таким образом, что вызовы функции ввода-вывода, использующие этот дескриптор, блокируются до их завершения, а асинхронный дескриптор файла позволяет системе немедленно возвращать данные из вызовов функции ввода-вывода независимо от того, завершена ли операция ввода-вывода или нет. Как упоминалось ранее, это синхронное и асинхронное поведение определяется указанием FILE_FLAG_OVERLAPPED в элементе dwFileFlagsструктуры CREATEFILE2_EXTENDED_PARAMETERS , переданной в параметре pCreateExParams . Существует несколько сложностей и потенциальных ошибок при использовании асинхронных операций ввода-вывода; Дополнительные сведения см. в разделе Синхронный и асинхронный ввод-вывод.

Требования

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

CreateFile2

Структуры управления файлами