enumerasi CF_CALLBACK_TYPE (cfapi.h)

Artikel
08/25/2023

Berisi berbagai jenis panggilan balik yang digunakan pada file atau folder tempat penampung.

Sintaks

typedef enum CF_CALLBACK_TYPE {
  CF_CALLBACK_TYPE_FETCH_DATA,
  CF_CALLBACK_TYPE_VALIDATE_DATA,
  CF_CALLBACK_TYPE_CANCEL_FETCH_DATA,
  CF_CALLBACK_TYPE_FETCH_PLACEHOLDERS,
  CF_CALLBACK_TYPE_CANCEL_FETCH_PLACEHOLDERS,
  CF_CALLBACK_TYPE_NOTIFY_FILE_OPEN_COMPLETION,
  CF_CALLBACK_TYPE_NOTIFY_FILE_CLOSE_COMPLETION,
  CF_CALLBACK_TYPE_NOTIFY_DEHYDRATE,
  CF_CALLBACK_TYPE_NOTIFY_DEHYDRATE_COMPLETION,
  CF_CALLBACK_TYPE_NOTIFY_DELETE,
  CF_CALLBACK_TYPE_NOTIFY_DELETE_COMPLETION,
  CF_CALLBACK_TYPE_NOTIFY_RENAME,
  CF_CALLBACK_TYPE_NOTIFY_RENAME_COMPLETION,
  CF_CALLBACK_TYPE_NONE = 0xffffffff
} ;

Konstanta


`CF_CALLBACK_TYPE_FETCH_DATA` Panggilan balik ini digunakan untuk meminta penyedia sinkronisasi untuk rentang data file yang diperlukan untuk memenuhi permintaan I/O, atau permintaan hidrasi eksplisit, pada tempat penampung. Implementasi panggilan balik ini diperlukan jika penyedia sinkronisasi menentukan kebijakan hidrasi yang tidakALWAYS_FULL pada waktu pendaftaran akar sinkronisasi.
`CF_CALLBACK_TYPE_VALIDATE_DATA` Panggilan balik ini digunakan untuk meminta pengakuan kepada penyedia sinkronisasi bahwa rentang data file tertentu, yang sudah ada pada disk dari operasi CF_OPERATION_TYPE_TRANSFER_DATA sebelumnya, valid dan oleh karena itu dapat digunakan oleh platform untuk memenuhi permintaan I/O pengguna. Implementasi panggilan balik ini diperlukan hanya jika penyedia sinkronisasi menentukan pengubah kebijakan hidrasi VALIDATION_REQUIRED pada waktu pendaftaran akar sinkronisasi.
`CF_CALLBACK_TYPE_CANCEL_FETCH_DATA` Panggilan balik ini digunakan untuk memberi tahu penyedia sinkronisasi bahwa rentang data file tidak lagi diperlukan, biasanya karena permintaan asal telah dibatalkan. Ini memungkinkan penyedia sinkronisasi berhenti menghabiskan upayanya untuk mencoba mendapatkan data (membatalkan permintaan jaringan yang luar biasa, dll.). Implementasi panggilan balik ini bersifat opsional.
`CF_CALLBACK_TYPE_FETCH_PLACEHOLDERS` Panggilan balik ini digunakan untuk meminta penyedia sinkronisasi untuk memberikan informasi tentang konten direktori tempat penampung untuk memenuhi operasi kueri direktori atau upaya untuk membuka file di bawah direktori. Implementasi panggilan balik ini diperlukan hanya jika penyedia sinkronisasi menentukan kebijakan selain CF_POPULATION_POLICY_ALWAYS_FULL pada waktu pendaftaran akar sinkronisasi.
`CF_CALLBACK_TYPE_CANCEL_FETCH_PLACEHOLDERS` Panggilan balik ini digunakan untuk memberi tahu penyedia sinkronisasi bahwa konten direktori tempat penampung tidak lagi diperlukan, biasanya karena permintaan asal telah dibatalkan. Ini memungkinkan penyedia sinkronisasi berhenti menghabiskan upayanya untuk mencoba mendapatkan konten (membatalkan permintaan jaringan yang luar biasa, dll.). Implementasi panggilan balik ini bersifat opsional.
`CF_CALLBACK_TYPE_NOTIFY_FILE_OPEN_COMPLETION` Panggilan balik ini digunakan untuk memberi tahu penyedia sinkronisasi bahwa tempat penampung di bawah salah satu akar sinkronisasinya telah berhasil dibuka untuk akses baca/tulis/hapus. Aplikasi pengguna yang melakukan pembukaan tidak diblokir. Tidak ada respons yang diharapkan dari penyedia sinkronisasi. Pemberitahuan ini tidak berlaku untuk direktori. Implementasi panggilan balik ini bersifat opsional.
`CF_CALLBACK_TYPE_NOTIFY_FILE_CLOSE_COMPLETION` Panggilan balik ini digunakan untuk memberi tahu penyedia sinkronisasi bahwa tempat penampung di bawah salah satu akar sinkronisasinya yang sebelumnya telah dibuka untuk akses baca/tulis/hapus sekarang ditutup. Aplikasi pengguna yang melakukan penutupan tidak diblokir. Tidak ada respons yang diharapkan dari penyedia sinkronisasi. Pemberitahuan ini tidak berlaku untuk direktori. Implementasi panggilan balik ini bersifat opsional.
`CF_CALLBACK_TYPE_NOTIFY_DEHYDRATE` Panggilan balik ini digunakan untuk memberi tahu penyedia sinkronisasi bahwa tempat penampung di bawah salah satu akar sinkronisasinya akan mengalami dehidrasi. Aplikasi pengguna yang melakukan dehidrasi diblokir. Respons diharapkan dari penyedia sinkronisasi. Implementasi panggilan balik ini bersifat opsional.
`CF_CALLBACK_TYPE_NOTIFY_DEHYDRATE_COMPLETION` Panggilan balik ini digunakan untuk memberi tahu penyedia sinkronisasi bahwa tempat penampung di bawah salah satu akar sinkronisasinya telah berhasil didehidrasi. Aplikasi pengguna yang melakukan dehidrasi tidak diblokir. Tidak ada respons yang diharapkan dari penyedia sinkronisasi. Implementasi panggilan balik ini bersifat opsional.
`CF_CALLBACK_TYPE_NOTIFY_DELETE` Panggilan balik ini digunakan untuk memberi tahu penyedia sinkronisasi bahwa tempat penampung di bawah salah satu akar sinkronisasinya akan dihapus. Aplikasi pengguna yang melakukan penghapusan diblokir. Respons diharapkan dari penyedia sinkronisasi. Implementasi panggilan balik ini bersifat opsional.
`CF_CALLBACK_TYPE_NOTIFY_DELETE_COMPLETION` Panggilan balik ini digunakan untuk memberi tahu penyedia sinkronisasi bahwa tempat penampung di bawah salah satu akar sinkronisasinya telah berhasil dihapus. Aplikasi pengguna yang melakukan penghapusan tidak diblokir. Tidak ada respons yang diharapkan dari penyedia sinkronisasi. Implementasi panggilan balik ini bersifat opsional.
`CF_CALLBACK_TYPE_NOTIFY_RENAME` Panggilan balik ini digunakan untuk memberi tahu penyedia sinkronisasi bahwa tempat penampung di bawah salah satu akar sinkronisasinya akan diganti namanya atau dipindahkan. Aplikasi pengguna yang melakukan penggantian nama/pemindahan diblokir. Respons diharapkan dari penyedia sinkronisasi. Implementasi panggilan balik ini bersifat opsional.
`CF_CALLBACK_TYPE_NOTIFY_RENAME_COMPLETION` Panggilan balik ini digunakan untuk memberi tahu penyedia sinkronisasi bahwa tempat penampung di bawah salah satu akar sinkronisasinya telah berhasil diganti namanya atau dipindahkan. Aplikasi pengguna yang melakukan penggantian nama/pemindahan tidak diblokir. Tidak ada respons yang diharapkan dari penyedia sinkronisasi. Implementasi panggilan balik ini bersifat opsional.
`CF_CALLBACK_TYPE_NONE` Nilai: 0xffffffff Tidak ada jenis panggilan balik.

Keterangan

Ini bukan API yang disediakan oleh pustaka, melainkan panggilan balik yang harus diterapkan penyedia sinkronisasi untuk melayani permintaan dari platform. Jika perlu, platform akan meminta instans pustaka yang berjalan di dalam proses penyedia sinkronisasi untuk memanggil rutinitas panggilan balik yang sesuai.

Rutinitas panggilan balik akan dipanggil dalam utas arbitrer (bagian dari kumpulan utas). Beberapa panggilan balik dapat terjadi secara bersamaan, di utas yang berbeda, dan merupakan tanggung jawab kode penyedia sinkronisasi untuk menerapkan sinkronisasi yang diperlukan untuk membuat ini bekerja dengan andal. Semua panggilan balik tidak sinkron. Permintaan pengguna asinkron yang memicu panggilan balik tertunda dan kontrol dikembalikan ke aplikasi pengguna.

Setiap permintaan panggilan balik memiliki batas waktu tetap 60 detik. Operasi yang valid pada setiap permintaan yang tertunda dari penyedia sinkronisasi mengatur ulang timer semua permintaan yang tertunda.

Semua fungsi panggilan balik memiliki prototipe yang sama dengan dua argumen: struktur CF_CALLBACK_INFO dan struktur CF_CALLBACK_PARAMETERS .

Rutinitas panggilan balik tidak memiliki nilai pengembalian.

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

CF_CALLBACK_INFO

CF_CALLBACK_PARAMETERS

Bagikan melalui