CF_SYNC_REGISTRATION-Struktur (cfapi.h)

  • Artikel

Die Details des zu registrierenden Synchronisierungsanbieters und des Synchronisierungsstamms.

Syntax

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

Member

StructSize

Die Größe der CF_SYNC_REGISTRATION-Struktur .

ProviderName

Der Name des Synchronisierungsanbieters. Dies ist eine benutzerfreundliche Zeichenfolge mit einer maximalen Länge von 255 Zeichen.

ProviderVersion

Die Version des Synchronisierungsanbieters. Dies ist eine benutzerfreundliche Zeichenfolge mit einer maximalen Länge von 255 Zeichen.

SyncRootIdentity

Die vom Anbieter verwendete Synchronisierungsstammidentität. Dieser Member ist optional mit einer maximalen Größe von 64 KB. Die API schlägt mit ERROR_INVALID_PARAMETER fehl, wenn die maximale Länge überschritten wird. Die Plattform stellt SyncRootIdentity in allen Rückrufen an den Synchronisierungsanbieter zurück.

SyncRootIdentityLength

Die Länge der SyncRootIdentity. Dieser Member ist optional und wird nur verwendet, wenn ein SyncRootIdentity-Element bereitgestellt wird.

FileIdentity

Eine optionale Dateiidentität. Dieser Member hat eine maximale Größe von 4 KB. Die API schlägt mit ERROR_INVALID_PARAMETER fehl, wenn die maximale Länge überschritten wird. Das FileIdentity-Blob für die Synchronisierung wird nur bereitgestellt, wenn der Betreff des Rückrufs der Synchronisierungsstamm selbst ist.

FileIdentityLength

Die Länge von FileIdentity. Dieses Element ist optional und wird nur verwendet, wenn ein FileIdentity-Element bereitgestellt wird.

ProviderId

Dies ist eine GUID, die einen bestimmten Synchronisierungsanbieter identifizieren soll. Der Vorgang ist optional. Falls nicht angegeben, generiert die Plattform mithilfe des MD5-Hashs der ProviderName-Zeichenfolge eine GUID. Die Informationen werden nur für Telemetriedaten verwendet, sodass die Plattform Aktivitäten desselben Synchronisierungsanbieters effizienter und genauer korrelieren kann, auch wenn der Synchronisierungsanbieter Synchronisierungswurzeln mit verschiedenen ProviderName-Zeichenfolgen registriert. Es wird empfohlen, dass ein Synchronisierungsanbieter immer dieselbe GUID für alle Versionen seiner Synchronisierungsprodukte bereitstellt. Auf der anderen Seite können Synchronisierungsanbieter verschiedene ProviderName-Zeichenfolgen auswählen, um die beste Benutzererfahrung zu gewährleisten.

Hinweise

SyncRootIdentity und SyncRootIdentityLength sind optionale Mitglieder. Wenn nicht verwendet, legen Sie SyncRootIdentity auf nullptr und SyncRootIdentityLength auf fest 0. FileIdentity und FileIdentityLength sind ebenfalls optional und sollten, falls nicht verwendet, auf nullptr bzw 0. festgelegt werden.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 10, Version 1709 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2016 [nur Desktop-Apps]
Kopfzeile cfapi.h

Weitere Informationen

CfRegisterSyncRoot