estructura CF_SYNC_REGISTRATION (cfapi.h)

Detalles del proveedor de sincronización y raíz de sincronización que se va a registrar.

Sintaxis

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

Miembros

StructSize

Tamaño de la estructura CF_SYNC_REGISTRATION .

ProviderName

Nombre del proveedor de sincronización. Se trata de una cadena fácil de usar con una longitud máxima de 255 caracteres.

ProviderVersion

Versión del proveedor de sincronización. Se trata de una cadena fácil de usar con una longitud máxima de 255 caracteres.

SyncRootIdentity

Identidad raíz de sincronización usada por el proveedor. Este miembro es opcional con un tamaño máximo de 64 KB. Se produce un error en la API con ERROR_INVALID_PARAMETER cuando se supera la longitud máxima. La plataforma devolverá SyncRootIdentity al proveedor de sincronización en las devoluciones de llamada al proveedor de sincronización.

SyncRootIdentityLength

Longitud de SyncRootIdentity. Este miembro es opcional y solo se usa si se proporciona syncRootIdentity .

FileIdentity

Una identidad de archivo opcional. Este miembro tiene un tamaño máximo de 4 KB. Se produce un error en la API con ERROR_INVALID_PARAMETER cuando se supera la longitud máxima. El blob de FileIdentity raíz de sincronización solo se proporcionará cuando el asunto de la devolución de llamada sea la propia raíz de sincronización.

FileIdentityLength

Longitud de FileIdentity. Este miembro es opcional y solo se usa si se proporciona fileIdentity .

ProviderId

Se trata de un GUID diseñado para identificar un proveedor de sincronización específico. Es opcional. Si no se proporciona, la plataforma genera un GUID mediante el hash MD5 de la cadena ProviderName . La información solo se usa para la telemetría de modo que la plataforma pueda correlacionar mejor las actividades del mismo proveedor de sincronización de forma más eficaz y precisa, incluso si el proveedor de sincronización registra raíces de sincronización con diferentes cadenas ProviderName . Se recomienda que un proveedor de sincronización proporcione siempre el mismo GUID para todas las versiones de sus productos de sincronización. Por otro lado, los proveedores de sincronización pueden elegir diferentes cadenas ProviderName para la mejor experiencia del usuario.

Comentarios

SyncRootIdentity y SyncRootIdentityLength son miembros opcionales. Si no se usa, establezca SyncRootIdentitynullptr en y SyncRootIdentityLength en 0. FileIdentity y FileIdentityLength también son opcionales y, si no se usan, deben establecerse nullptr en y 0, respectivamente.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 10, versión 1709 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2016 [solo aplicaciones de escritorio]
Encabezado	cfapi.h

Consulte también

CfRegisterSyncRoot