Fungsi CfExecute (cfapi.h)

Titik masuk utama untuk semua operasi tempat penampung berbasis kunci koneksi. Ini dimaksudkan untuk digunakan oleh penyedia sinkronisasi untuk menanggapi berbagai panggilan balik dari platform.

HRESULT CfExecute(
  [in]      const CF_OPERATION_INFO *OpInfo,
  [in, out] CF_OPERATION_PARAMETERS *OpParams
);

[in] OpInfo

Informasi tentang operasi pada tempat penampung.

[in, out] OpParams

Parameter operasi pada tempat penampung.

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

Panggilan yang valid ke CfExecute akan mengatur ulang timer semua permintaan panggilan balik yang tertunda yang termasuk dalam proses penyedia sinkronisasi yang sama.

CfExecute mengambil dua argumen berukuran variabel, yaitu, CF_OPERATION_INFO dan CF_OPERATION_PARAMETERS, dengan satu mengidentifikasi jenis operasi dan yang lain memasok parameter operasi terperinci. Kedua argumen dimulai dengan bidang StructSize di awal struktur yang sesuai. Penelepon CfExecute bertanggung jawab untuk akuntansi ukuran struktur yang akurat.

Platform ini menyediakan ConnectionKey, TransferKey, dan CorrelationVector ke semua fungsi panggilan balik yang terdaftar di CfConnectSyncRoot. Selain itu, penyedia sinkronisasi dapat memperoleh TransferKey menggunakan CfGetTransferKey dan CorrelationVector menggunakan CfGetCorrelationVector.

Secara opsional, penyedia sinkronisasi dapat menyediakan blob status sinkronisasi ke platform. Jika pointer non-null diatur di bidang SyncStatus di CF_OPERATION_INFO, kontennya akan disimpan pada file hingga handel terakhir di dalamnya dihapus. Platform akan mengkueri informasi ini setelah operasi yang gagal pada tempat penampung file cloud. Jika tersedia, platform akan menggunakan informasi yang diberikan untuk membuat pesan yang lebih bermakna dan dapat ditindak lanjuti kepada pengguna.

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

Semua operasi dapat dilakukan dalam konteks utas arbitrer dalam proses penyedia sinkronisasi.

CfConnectSyncRoot

CfGetCorrelationVector

CF_OPERATION_INFO

CF_OPERATION_PARAMETERS