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

Сведения о поставщике синхронизации и корневом каталоге синхронизации для регистрации.

Синтаксис

typedef struct CF_SYNC_REGISTRATION {
  ULONG   StructSize;
  LPCWSTR ProviderName;
  LPCWSTR ProviderVersion;
  LPCVOID SyncRootIdentity;
  DWORD   SyncRootIdentityLength;
  LPCVOID FileIdentity;
  DWORD   FileIdentityLength;
  GUID    ProviderId;
} CF_SYNC_REGISTRATION;

Члены

StructSize

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

ProviderName

Имя поставщика синхронизации. Это удобная для пользователя строка длиной не более 255 символов.

ProviderVersion

Версия поставщика синхронизации. Это удобная для пользователя строка длиной не более 255 символов.

SyncRootIdentity

Корневое удостоверение синхронизации, используемое поставщиком. Этот элемент является необязательным с максимальным размером 64 КБ. Api завершается сбоем с ERROR_INVALID_PARAMETER при превышении максимальной длины. Платформа будет предоставлять SyncRootIdentity обратно поставщику синхронизации в любых обратных вызовах к поставщику синхронизации.

SyncRootIdentityLength

Длина элемента SyncRootIdentity. Этот элемент является необязательным и используется только в том случае, если указан параметр SyncRootIdentity .

FileIdentity

Необязательное удостоверение файла. Максимальный размер этого элемента составляет 4 КБ. Api завершается сбоем с ERROR_INVALID_PARAMETER при превышении максимальной длины. Корневой blob-объект синхронизации FileIdentity будет предоставляться только в том случае, если субъектом обратного вызова является сам корень синхронизации.

FileIdentityLength

Длина объекта FileIdentity. Этот элемент является необязательным и используется только в том случае, если указан параметр FileIdentity .

ProviderId

Это GUID, предназначенный для идентификации конкретного поставщика синхронизации. Этот параметр необязателен. Если этот параметр не указан, платформа создает ИДЕНТИФИКАТОР GUID, используя хэш MD5 строки ProviderName . Эти сведения используются только для телеметрии, чтобы платформа лучше сопоставляла действия одного и того же поставщика синхронизации более эффективно и точнее, даже если поставщик синхронизации регистрирует корень синхронизации с разными строками ProviderName . Рекомендуется, чтобы поставщик синхронизации всегда предоставлял один и тот же GUID для всех версий своих продуктов синхронизации. С другой стороны, поставщики синхронизации могут выбирать различные строки ProviderName для оптимального взаимодействия с пользователем.

Комментарии

SyncRootIdentity и SyncRootIdentityLength являются необязательными элементами. Если он не используется, задайте для SyncRootIdentity значение nullptr , а для SyncRootIdentityLength — значение 0. FileIdentity и FileIdentityLength также являются необязательными. Если они не используются, следует задать значения nullptr и 0соответственно.

Требования

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

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

CfRegisterSyncRoot