struktur CF_SYNC_REGISTRATION (cfapi.h)

2024-02-26

Detail penyedia sinkronisasi dan akar sinkronisasi yang akan didaftarkan.

Sintaks

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

Anggota

StructSize

Ukuran struktur CF_SYNC_REGISTRATION .

ProviderName

Nama penyedia sinkronisasi. Ini adalah string ramah pengguna dengan panjang maksimum 255 karakter.

ProviderVersion

Versi penyedia sinkronisasi. Ini adalah string ramah pengguna dengan panjang maksimum 255 karakter.

SyncRootIdentity

Identitas akar sinkronisasi yang digunakan oleh penyedia. Anggota ini bersifat opsional dengan ukuran maksimum 64 KB. API gagal dengan ERROR_INVALID_PARAMETER ketika panjang maksimum terlampaui. Platform akan menyediakan SyncRootIdentity kembali ke penyedia sinkronisasi dalam panggilan balik apa pun ke penyedia sinkronisasi.

SyncRootIdentityLength

Panjang SyncRootIdentity. Anggota ini bersifat opsional dan hanya digunakan jika SyncRootIdentity disediakan.

FileIdentity

Identitas file opsional. Anggota ini memiliki ukuran maksimum 4 KB. API gagal dengan ERROR_INVALID_PARAMETER ketika panjang maksimum terlampaui. Blob FileIdentity akar sinkronisasi hanya akan disediakan ketika subjek panggilan balik adalah akar sinkronisasi itu sendiri.

FileIdentityLength

Panjang FileIdentity. Anggota ini bersifat opsional dan hanya digunakan jika FileIdentity disediakan.

ProviderId

Ini adalah GUID yang dimaksudkan untuk mengidentifikasi penyedia sinkronisasi tertentu. Ini opsional. Jika tidak disediakan, platform menghasilkan GUID menggunakan hash MD5 dari string ProviderName . Informasi ini digunakan untuk telemetri hanya sia-sia sehingga platform dapat menghubungkan aktivitas dengan lebih baik dari penyedia sinkronisasi yang sama dengan lebih efisien dan lebih akurat bahkan jika penyedia sinkronisasi mendaftarkan root sinkronisasi dengan string ProviderName yang berbeda. Disarankan agar penyedia sinkronisasi selalu menyediakan GUID yang sama untuk semua versi produk sinkronisasinya. Di sisi lain, penyedia sinkronisasi bebas memilih string ProviderName yang berbeda demi pengalaman pengguna terbaik.

Keterangan

SyncRootIdentity dan SyncRootIdentityLength adalah anggota opsional. Jika tidak digunakan, atur SyncRootIdentity ke nullptr dan SyncRootIdentityLength ke 0. FileIdentity dan FileIdentityLength juga opsional dan jika tidak digunakan harus diatur ke nullptr dan 0, masing-masing.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 10, versi 1709 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2016 [hanya aplikasi desktop]
Header	cfapi.h

Lihat juga

CfRegisterSyncRoot

Bagikan melalui