CF_SYNC_REGISTRATION-Struktur (cfapi.h)
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 |