struktur CF_SYNC_STATUS (cfapi.h)

Digunakan dalam struktur CF_OPERATION_INFO untuk menjelaskan status akar sinkronisasi tertentu.

Sintaks

typedef struct CF_SYNC_STATUS {
  ULONG StructSize;
  ULONG Code;
  ULONG DescriptionOffset;
  ULONG DescriptionLength;
  ULONG DeviceIdOffset;
  ULONG DeviceIdLength;
} CF_SYNC_STATUS;

Anggota

StructSize

Ukuran, dalam byte, dari struktur status sinkronisasi, termasuk string deskripsi aktual.

Code

Penggunaan parameter ini sepenuhnya terserah penyedia sinkronisasi yang mendukung konstruksi status sinkronisasi kaya ini.

Untuk penyedia sinkronisasi tertentu, diharapkan ada pemetaan 1:1 antara kode dan string deskripsi.

Disarankan agar Anda menggunakan urutan bit tertinggi untuk menjelaskan jenis kode kesalahan: 1 untuk kode tingkat kesalahan, dan 0 untuk kode tingkat informasi.

DescriptionOffset

Offset string deskripsi relatif terhadap awal CF_SYNC_STATUS. Ini menunjuk ke string lebar yang dihentikan null yang dilokalkan yang diharapkan berisi informasi yang lebih bermakna dan dapat ditindak lanjuti tentang file yang dimaksud. Penyedia sinkronisasi diharapkan menyeimbangkan persyaratan untuk memberikan informasi yang lebih dapat ditindaklanjuti dan mempertahankan jejak memori sesedikim mungkin.

DescriptionLength

Ukuran string deskripsi, dalam byte, yang mencakup terminator null.

DeviceIdOffset

Offset blob id perangkat relatif terhadap awal CF_SYNC_STATUS. Blob id perangkat bersifat opsional dan buram ke platform. Blob diharapkan unik berdasarkan per perangkat. Jika disediakan, blob akan dikumpulkan sebagai bagian dari telemetri platform untuk membantu mendiagnosis masalah teknis.

DeviceIdLength

Ukuran blob id perangkat, dalam byte.

Keterangan

Jika penunjuk null diatur di bidang SyncStatus dari struktur CF_OPERATION_INFO , platform akan menghapus status sinkronisasi yang ditetapkan sebelumnya, jika ada.

Persyaratan

Lihat juga

CF_OPERATION_INFO