struttura CF_SYNC_REGISTRATION (cfapi.h)

Articolo
02/23/2024

Dettagli del provider di sincronizzazione e della radice di sincronizzazione da registrare.

Sintassi

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

Members

StructSize

Dimensioni della struttura CF_SYNC_REGISTRATION .

ProviderName

Nome del provider di sincronizzazione. Si tratta di una stringa intuitiva con una lunghezza massima di 255 caratteri.

ProviderVersion

Versione del provider di sincronizzazione. Si tratta di una stringa intuitiva con una lunghezza massima di 255 caratteri.

SyncRootIdentity

Identità radice di sincronizzazione usata dal provider. Questo membro è facoltativo con una dimensione massima di 64 KB. L'API ha esito negativo con ERROR_INVALID_PARAMETER quando viene superata la lunghezza massima. La piattaforma fornirà SyncRootIdentity al provider di sincronizzazione in qualsiasi callback al provider di sincronizzazione.

SyncRootIdentityLength

Lunghezza dell'oggetto SyncRootIdentity. Questo membro è facoltativo e viene usato solo se viene fornito un oggetto SyncRootIdentity .

FileIdentity

Un'identità di file facoltativa. Questo membro ha una dimensione massima di 4 KB. L'API ha esito negativo con ERROR_INVALID_PARAMETER quando viene superata la lunghezza massima. Il BLOB FileIdentity radice di sincronizzazione verrà fornito solo quando l'oggetto del callback è la radice di sincronizzazione stessa.

FileIdentityLength

Lunghezza dell'oggetto FileIdentity. Questo membro è facoltativo e viene usato solo se viene specificato un oggetto FileIdentity .

ProviderId

Si tratta di un GUID progettato per identificare un provider di sincronizzazione specifico. Questo passaggio è facoltativo. Se non specificato, la piattaforma genera un GUID usando l'hash MD5 della stringa ProviderName . Le informazioni vengono usate solo per la telemetria in modo che la piattaforma possa correlare meglio le attività dello stesso provider di sincronizzazione in modo più efficiente e più accurato anche se il provider di sincronizzazione registra radici di sincronizzazione con stringhe ProviderName diverse. È consigliabile che un provider di sincronizzazione fornisca sempre lo stesso GUID per tutte le versioni dei prodotti di sincronizzazione. D'altra parte, i provider di sincronizzazione sono liberi di scegliere stringhe ProviderName diverse per il meglio dell'esperienza utente.

Commenti

SyncRootIdentity e SyncRootIdentityLength sono membri facoltativi. Se non viene usato, impostare SyncRootIdentity su nullptr e SyncRootIdentityLength su 0. FileIdentity e FileIdentityLength sono facoltativi e, se non viene usato, devono essere impostati rispettivamente su nullptr e 0.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 10 versione 1709 [solo app desktop]
Server minimo supportato	Windows Server 2016 [solo app desktop]
Intestazione	cfapi.h

Vedi anche

CfRegisterSyncRoot

Condividi tramite