Поделиться через

перечисление CF_UPDATE_FLAGS (cfapi.h)

  • Статья

Флаги для обновления файла заполнителя или каталога.

Синтаксис

typedef enum CF_UPDATE_FLAGS {
  CF_UPDATE_FLAG_NONE,
  CF_UPDATE_FLAG_VERIFY_IN_SYNC,
  CF_UPDATE_FLAG_MARK_IN_SYNC,
  CF_UPDATE_FLAG_DEHYDRATE,
  CF_UPDATE_FLAG_ENABLE_ON_DEMAND_POPULATION,
  CF_UPDATE_FLAG_DISABLE_ON_DEMAND_POPULATION,
  CF_UPDATE_FLAG_REMOVE_FILE_IDENTITY,
  CF_UPDATE_FLAG_CLEAR_IN_SYNC,
  CF_UPDATE_FLAG_REMOVE_PROPERTY,
  CF_UPDATE_FLAG_PASSTHROUGH_FS_METADATA,
  CF_UPDATE_FLAG_ALWAYS_FULL,
  CF_UPDATE_FLAG_ALLOW_PARTIAL
} ;

Константы

 
CF_UPDATE_FLAG_NONE
0x00000000

Флаги обновления отсутствуют.
CF_UPDATE_FLAG_VERIFY_IN_SYNC
0x00000001

Обновление завершится ошибкой, если атрибут CF_UPDATE_FLAG_MARK_IN_SYNC в настоящее время не задан для заполнителя. Это необходимо для предотвращения гонки между синхронизацией изменений из облака с локальным заполнителем и локальным изменением потока данных заполнителя.
CF_UPDATE_FLAG_MARK_IN_SYNC
0x00000002

Платформа помечает заполнитель как синхронизированный после успешной операции обновления заполнителя.
CF_UPDATE_FLAG_DEHYDRATE
0x00000004

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

Применимо только к каталогам. При указании обновленный каталог заполнителей помечается частично заполненным таким образом, что любой будущий доступ к нему приведет к FETCH_PLACEHOLDERS обратному вызову, отправленном поставщику синхронизации.
CF_UPDATE_FLAG_DISABLE_ON_DEMAND_POPULATION
0x00000010

Применимо только к каталогам. При указании обновленный каталог заполнителей помечается полностью заполненным таким образом, что любой будущий доступ к нему будет обрабатываться платформой без обратных вызовов к поставщику синхронизации.
CF_UPDATE_FLAG_REMOVE_FILE_IDENTITY
0x00000020

Если этот параметр указан, fileIdentity и FileIdentityLength в CfUpdatePlaceholder игнорируются, и платформа удалит существующий blob-объект идентификатора файла в заполнитель после успешного вызова обновления.
CF_UPDATE_FLAG_CLEAR_IN_SYNC
0x00000040

Платформа помечает заполнитель как не синхронизированный после успешной операции обновления заполнителя.
CF_UPDATE_FLAG_REMOVE_PROPERTY
0x00000080

Платформа удаляет все существующие экстринсические свойства заполнителя.

ПРИМЕЧАНИЕ

Это значение доступно в Windows 10 версии 1803 и более поздних.
CF_UPDATE_FLAG_PASSTHROUGH_FS_METADATA
0x00000100

Платформа передает CF_FS_METADATA в файловую систему без фильтрации; В противном случае платформа пропускает установку полей со значением 0.

ПРИМЕЧАНИЕ

Это значение доступно в Windows 10 версии 1803 и более поздних.
CF_UPDATE_FLAG_ALWAYS_FULL
0x00000200

CF_UPDATE_FLAG_ALWAYS_FULL действует только для файлов заполнителей. При указании заполнитель, который необходимо обновить, всегда помечается полным. После гидратации любая попытка обезвожить такой файл заполнителя завершится ошибкой с кодом ERROR_CLOUD_FILE_DEHYDRATION_DISALLOWED.
CF_UPDATE_FLAG_ALLOW_PARTIAL
0x00000400

CF_UPDATE_FLAG_ALLOW_PARTIAL действует только для файлов заполнителей. При указании всегда полное состояние в файле заполнителя, если оно имеется, очищается, что позволяет снова обезвоживать его. Недопустимо указывать этот флаг вместе с CF_UPDATE_FLAG_ALWAYS_FULL и в результате будет возвращен код ERROR_CLOUD_FILE_INVALID_REQUEST ошибки.

Требования

Требование Значение
Минимальная версия клиента Windows 10, версия 1709 [только классические приложения]
Минимальная версия сервера Windows Server 2016 [только классические приложения]
Верхняя часть cfapi.h

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

CfUpdatePlaceholder