CF_SYNC_REGISTRATION 結構 (cfapi.h)
要註冊的同步提供者和同步根目錄的詳細數據。
語法
typedef struct CF_SYNC_REGISTRATION {
ULONG StructSize;
LPCWSTR ProviderName;
LPCWSTR ProviderVersion;
LPCVOID SyncRootIdentity;
DWORD SyncRootIdentityLength;
LPCVOID FileIdentity;
DWORD FileIdentityLength;
GUID ProviderId;
} CF_SYNC_REGISTRATION;
成員
StructSize
CF_SYNC_REGISTRATION 結構的大小。
ProviderName
同步提供者的名稱。 這是用戶易記的字串，最大長度為 255 個字元。
ProviderVersion
同步提供者的版本。 這是用戶易記的字串，最大長度為 255 個字元。
SyncRootIdentity
提供者所使用的同步根識別。 此成員是選擇性的，大小上限為 64 KB。 當超過最大長度時，API 會失敗 ，且ERROR_INVALID_PARAMETER 。 平臺會在同步提供者的任何回呼中，將 SyncRootIdentity 提供給同步提供者。
SyncRootIdentityLength
SyncRootIdentity 的長度。 這個成員是選擇性的，只有在提供 SyncRootIdentity 時才使用。
FileIdentity
選擇性檔案身分識別。 此成員的大小上限為 4 KB。 當超過最大長度時，API 會失敗 ，且ERROR_INVALID_PARAMETER 。 只有在回呼的主旨是同步根目錄本身時，才會提供同步根 FileIdentity Blob。
FileIdentityLength
FileIdentity 的長度。 這個成員是選擇性的，只有在提供 FileIdentity 時才使用。
ProviderId
這是用來識別特定同步提供者的 GUID。 此為選用項目。 如果未提供，平臺會使用 ProviderName 字串的 MD5 哈希來產生 GUID。 此資訊只會用於遙測，因此平臺可以更有效率且更精確地將來自相同同步提供者的活動相互關聯，即使同步提供者向不同的 ProviderName 字串註冊同步根目錄也一樣。 建議同步提供者一律為同步處理產品的所有版本提供相同的 GUID (s) 。 另一方面，同步提供者可以自由選擇不同的 ProviderName 字串，以獲得最佳用戶體驗。
備註
SyncRootIdentity 和 SyncRootIdentityLength 是選擇性成員。 如果未使用，請將 SyncRootIdentity 設定為 ， nullptr 並將 SyncRootIdentityLength 設定為 0。 FileIdentity 和 FileIdentityLength 也是選擇性的，如果未分別使用則設定為 nullptr 和 0。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 10 1709 版 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2016 [僅限傳統型應用程式] |
| 標頭 | cfapi.h |