Fungsi CfSetInSyncState (cfapi.h)

Mengatur status dalam sinkronisasi untuk file atau folder tempat penampung.

Sintaks

HRESULT CfSetInSyncState(
  [in]                HANDLE               FileHandle,
  [in]                CF_IN_SYNC_STATE     InSyncState,
  [in]                CF_SET_IN_SYNC_FLAGS InSyncFlags,
  [in, out, optional] USN                  *InSyncUsn
);

Parameter

[in] FileHandle

Handel ke tempat penampung. Platform ini menyinkronkan operasi dengan benar dengan permintaan aktif lainnya. Atribut atau handel tanpa akses sudah cukup. Pemanggil harus memiliki akses WRITE_DATA atau WRITE_DAC ke tempat penampung.

[in] InSyncState

Status dalam sinkronisasi. InSyncState dapat diatur ke salah satu nilai berikut:

• Jika CF_IN_SYNC_STATE_NOT_IN_SYNC ditentukan, platform akan menghapus status dalam sinkronisasi tempat penampung setelah pengembalian yang berhasil dari panggilan API.
• Jika CF_IN_SYNC_STATE_IN_SYNC ditentukan, platform menetapkan status dalam sinkronisasi tempat penampung setelah pengembalian yang berhasil dari panggilan API.

[in] InSyncFlags

Bendera status dalam sinkronisasi. Lihat CF_SET_IN_SYNC_FLAGS untuk detail selengkapnya.

[in, out, optional] InSyncUsn

Ketika ditentukan, pada input, InSyncUsn menginstruksikan platform untuk hanya melakukan pengaturan dalam sinkronisasi jika file masih memiliki nilai USN yang sama dengan yang diteruskan. Ini untuk menutup perlombaan di mana penyedia sinkronisasi baru saja menyinkronkan tempat penampung berubah hingga cloud, tetapi sebelum panggilan ke CfSetInSyncState, tempat penampung berubah dalam beberapa cara. Meneruskan pointer ke nilai USN pada 0 input sama dengan meneruskan NULL pointer. Saat kembali, InSYncUsn menerima nilai USN akhir setelah mengatur status dalam sinkronisasi.

Menampilkan nilai

Jika fungsi ini berhasil, fungsi akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Persyaratan

Lihat juga

CF_IN_SYNC_STATE

CF_SET_IN_SYNC_FLAGS