структура CF_SYNC_POLICIES (cfapi.h)

Определяет политики синхронизации, используемые корнем синхронизации.

Синтаксис

typedef struct CF_SYNC_POLICIES {
  ULONG                            StructSize;
  CF_HYDRATION_POLICY              Hydration;
  CF_POPULATION_POLICY             Population;
  CF_INSYNC_POLICY                 InSync;
  CF_HARDLINK_POLICY               HardLink;
  CF_PLACEHOLDER_MANAGEMENT_POLICY PlaceholderManagement;
} CF_SYNC_POLICIES;

Члены

StructSize

Размер CF_SYNC_POLICIES структуры.

Hydration

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

Основная политика имеет четыре возможных значения:

В настоящее время поддерживаются три модификатора политики: VALIDATION_REQUIRED, STREAMING_ALLOWEDи AUTO_DEHYDRATION_ALLOWED. Как правило, модификаторы можно смешивать и сопоставлять с любыми основными политиками и другими модификаторами политики, если сочетание не является самосоединяющимся.

Population

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

InSync

Политика InSync позволяет поставщику синхронизации контролировать, когда платформа должна очищать синхронизированное состояние заполнителя. Помимо постоянной очистки синхронизированных при любом изменении данных, платформа в настоящее время может очищать синхронизированные изменения любых сочетаний трех атрибутов файла (ReadOnly, System и Hidden) и двух файлов (CreateTime и LastWriteTime). Эти политики можно применять к файлам и каталогам отдельно.

HardLink

По умолчанию платформа не позволяет создавать жесткие ссылки для любого заполнителя. Однако поставщики синхронизации, способные обрабатывать жесткие связи, могут указать платформе включить поддержку с помощью ALLOWED политики. С помощью этой политики приложения могут создавать столько жестких ссылок, сколько поддерживает файловая система, при условии, что ссылки находятся в одном корневом каталоге синхронизации или не находятся в корне синхронизации. Платформа принудительно удаляет заполнитель при появлении первой корневой ссылки вне синхронизации и отменить изменения заполнитель в обычный файл при удалении последней корневой ссылки в синхронизации. Создание жесткой ссылки, несовместимой с политикой, завершится ошибкой HRESULT ERROR_CLOUD_FILES_INCOMPATIBLE_HARDLINKS. Операции заполнителей, несовместимые с политикой, также завершатся ошибкой с ERROR_CLOUD_FILES_INCOMPATIBLE_HARDLINKS.

PlaceholderManagement

По умолчанию только поставщик синхронизации может выполнять операции управления заполнителями в корневом каталоге синхронизации. Процессы поставщика без синхронизации могут выполнять операции управления заполнителями, только если корень синхронизации неактивен (т. е. если к корню синхронизации не подключены поставщики синхронизации). Эти политики, если они включены, позволяют процессам поставщика, не выполняющего синхронизацию, выполнять соответствующие операции управления заполнителями в активном корневом каталоге синхронизации. CF_PLACEHOLDER_MANAGEMENT_POLICY_DEFAULT — это политика по умолчанию, позволяющая выполнять любые операции управления заполнителями только подключенным поставщиком синхронизации. Три приведенные ниже политики можно указать в любом сочетании:

Требования

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

CfCreatePlaceholders

CfConvertToPlaceholder

CfGetPlatformInfo