CF_SYNC_REGISTRATION structure (cfapi.h)

Article
02/26/2024

Détails du fournisseur de synchronisation et de la racine de synchronisation à inscrire.

Syntaxe

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

Membres

StructSize

Taille de la structure CF_SYNC_REGISTRATION .

ProviderName

Nom du fournisseur de synchronisation. Il s’agit d’une chaîne conviviale d’une longueur maximale de 255 caractères.

ProviderVersion

Version du fournisseur de synchronisation. Il s’agit d’une chaîne conviviale d’une longueur maximale de 255 caractères.

SyncRootIdentity

Identité racine de synchronisation utilisée par le fournisseur. Ce membre est facultatif avec une taille maximale de 64 Ko. L’API échoue avec ERROR_INVALID_PARAMETER lorsque la longueur maximale est dépassée. La plateforme fournit SyncRootIdentity au fournisseur de synchronisation dans tous les rappels au fournisseur de synchronisation.

SyncRootIdentityLength

Longueur de SyncRootIdentity. Ce membre est facultatif et est utilisé uniquement si un SyncRootIdentity est fourni.

FileIdentity

Identité de fichier facultative. Ce membre a une taille maximale de 4 Ko. L’API échoue avec ERROR_INVALID_PARAMETER lorsque la longueur maximale est dépassée. L’objet blob FileIdentity racine de synchronisation est fourni uniquement lorsque l’objet du rappel est la racine de synchronisation elle-même.

FileIdentityLength

Longueur de FileIdentity. Ce membre est facultatif et est utilisé uniquement si un FileIdentity est fourni.

ProviderId

Il s’agit d’un GUID destiné à identifier un fournisseur de synchronisation spécifique. Ce nom est facultatif. Si elle n’est pas fournie, la plateforme génère un GUID à l’aide du hachage MD5 de la chaîne ProviderName . Les informations sont utilisées uniquement pour la télémétrie, de sorte que la plateforme peut mieux mettre en corrélation les activités du même fournisseur de synchronisation de manière plus efficace et plus précise, même si le fournisseur de synchronisation inscrit des racines de synchronisation avec différentes chaînes ProviderName . Il est recommandé qu’un fournisseur de synchronisation fournisse toujours le même GUID pour toutes les versions de ses produits de synchronisation. En revanche, les fournisseurs de synchronisation sont libres de choisir différentes chaînes ProviderName pour une expérience utilisateur optimale.

Remarques

SyncRootIdentity et SyncRootIdentityLength sont des membres facultatifs. S’il n’est pas utilisé, définissez SyncRootIdentity sur nullptr et SyncRootIdentityLength sur 0. FileIdentity et FileIdentityLength sont également facultatifs et, s’ils ne sont pas utilisés, doivent être définis nullptr sur et 0, respectivement.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 10, version 1709 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2016 (applications de bureau uniquement)
En-tête	cfapi.h

Voir aussi

CfRegisterSyncRoot

Partager via