struktur CF_OPERATION_PARAMETERS (cfapi.h)

2023-04-11

Parameter terperinci dari operasi pada file atau folder tempat penampung. Data yang disediakan dalam struktur ini khusus untuk CF_OPERATION_TYPE operasi.

Sintaks

typedef struct CF_OPERATION_PARAMETERS {
  ULONG ParamSize;
  union {
    struct {
      CF_OPERATION_TRANSFER_DATA_FLAGS Flags;
      NTSTATUS                         CompletionStatus;
      LPCVOID                          Buffer;
      LARGE_INTEGER                    Offset;
      LARGE_INTEGER                    Length;
    } TransferData;
    struct {
      CF_OPERATION_RETRIEVE_DATA_FLAGS Flags;
      LPVOID                           Buffer;
      LARGE_INTEGER                    Offset;
      LARGE_INTEGER                    Length;
      LARGE_INTEGER                    ReturnedLength;
    } RetrieveData;
    struct {
      CF_OPERATION_ACK_DATA_FLAGS Flags;
      NTSTATUS                    CompletionStatus;
      LARGE_INTEGER               Offset;
      LARGE_INTEGER               Length;
    } AckData;
    struct {
      CF_OPERATION_RESTART_HYDRATION_FLAGS Flags;
      const CF_FS_METADATA                 *FsMetadata;
      LPCVOID                              FileIdentity;
      DWORD                                FileIdentityLength;
    } RestartHydration;
    struct {
      CF_OPERATION_TRANSFER_PLACEHOLDERS_FLAGS Flags;
      NTSTATUS                                 CompletionStatus;
      LARGE_INTEGER                            PlaceholderTotalCount;
      CF_PLACEHOLDER_CREATE_INFO               *PlaceholderArray;
      DWORD                                    PlaceholderCount;
      DWORD                                    EntriesProcessed;
    } TransferPlaceholders;
    struct {
      CF_OPERATION_ACK_DEHYDRATE_FLAGS Flags;
      NTSTATUS                         CompletionStatus;
      LPCVOID                          FileIdentity;
      DWORD                            FileIdentityLength;
    } AckDehydrate;
    struct {
      CF_OPERATION_ACK_RENAME_FLAGS Flags;
      NTSTATUS                      CompletionStatus;
    } AckRename;
    struct {
      CF_OPERATION_ACK_DELETE_FLAGS Flags;
      NTSTATUS                      CompletionStatus;
    } AckDelete;
  } DUMMYUNIONNAME;
} CF_OPERATION_PARAMETERS;

Anggota

ParamSize

DUMMYUNIONNAME

DUMMYUNIONNAME.TransferData

Penyedia sinkronisasi melakukan TRANSFER_DATA untuk menghidrasi file tempat penampung. Operasi ini dapat dilakukan sebagai respons terhadap panggilan balik FETCH_DATA , panggilan balik VALIDATE_DATA , atau sebagai bagian dari upaya hidrasi latar belakang preemptive di luar konteks panggilan balik apa pun.

API ini hanya berlaku untuk penyedia sinkronisasi yang mendukung kebijakan hidrasi yang kurang dari ALWAYS_FULL. Jika tidak, operasi akan gagal dengan ERROR_CLOUD_FILE_INVALID_REQUEST.

Penyedia sinkronisasi diharuskan memiliki akses WRITE_DATA atau WRITE_DAC ke file tempat operasi TRANSFER_DATA akan dilakukan. Jika tidak, operasi akan gagal dengan ERROR_CLOUD_FILE_ACCESS_DENIED.

Untuk melakukan operasi ini:

OpInfo.Type harus diatur ke CF_OPERATION_TYPE_TRANSFER_DATA.
OpParams.ParamSize harus diatur ke ukuran OpParams.TransferData yang tepat ditambah offset OpParams.TransferData.
OpParams.TransferData.Flags harus diatur ke CF_OPERATION_TRANSFER_DATA_FLAG_NONE.
OpParams.TransferData.CompletionStatus harus diatur ke STATUS_SUCCESS jika penyedia sinkronisasi ingin mentransfer data ke file tempat penampung. Jika penyedia sinkronisasi gagal memproses permintaan hidrasi karena alasan apa pun dan tidak ingin memulai ulang hidrasi, penyedia sinkronisasi harus menetapkan status STATUS_CLOUD_FILE_* di CompletionStatus. Kode status apa pun yang dikembalikan di luar rentang STATUS_CLOUD_FILE_* kecuali untuk STATUS_SUCCESS akan dikonversi ke STATUS_CLOUD_FILE_UNSUCCESSFUL oleh platform.
OpParams.TransferData.Buffer harus menunjuk ke buffer mode pengguna yang valid jika OpParams.TransferData.CompletionStatusSTATUS_SUCCESS dan harus setidaknya byte OpParams.TransferData.Length ; jika tidak, bidang buffer diabaikan.
OpParams.TransferData.Offset dan OpParams.TransferData.Length menjelaskan rentang di tempat penampung tempat penyedia sinkronisasi mentransfer data. Tidak ada persyaratan bahwa penyedia sinkronisasi mengembalikan semua data seperti yang diminta dalam satu bidikan. Tidak masalah juga bagi penyedia sinkronisasi untuk mengembalikan lebih banyak data daripada yang diminta. Sebagai contoh, penyedia sinkronisasi dapat memutuskan untuk membaca secara berlebihan, karena performa atau alasan lainnya. Penyedia sinkronisasi juga dapat melakukan beberapa operasi TRANSFER_DATA berulang kali sebagai respons terhadap panggilan balik FETCH_DATA yang sama. Satu-satunya persyaratan adalah bahwa offset dan panjangnya selaras 4KB kecuali rentang yang dijelaskan berakhir pada ukuran file logis (EoF), dalam hal ini, panjangnya tidak diperlukan untuk 4KB selaras selama rentang yang dihasilkan berakhir pada atau di luar ukuran file logis.

Setelah operasi selesai:

Jika penyedia sinkronisasi tidak menentukan VALIDATION_REQUIRED pada waktu pendaftaran akar sinkronisasi.

Dalam kasus transfer yang berhasil, setiap permintaan IO pengguna yang tertunda n file tempat penampung yang telah menerima semua byte yang diperlukan sebagai akibat dari transfer akan selesai; jika tidak, permintaan IO pengguna yang tidak lengkap akan diperbarui untuk mencerminkan status hidrasi terbaru. Dalam kasus transfer yang gagal, setiap permintaan IO pengguna yang tertunda pada file tempat penampung yang tumpang tindih dengan rentang seperti yang dijelaskan oleh offset dan panjang akan gagal dengan OpParams.TransferData.CompletionStatus.

Jika penyedia sinkronisasi menentukan VALIDATION_REQUIRED pada waktu pendaftaran akar sinkronisasi maka tidak ada lagi pemrosesan yang akan dilakukan oleh platform sampai data dalam rentang diakui secara positif oleh penyedia sinkronisasi melalui operasi ACK_DATA .

DUMMYUNIONNAME.TransferData.Flags

Bendera untuk mentransfer data. Ini harus diatur ke CF_OPERATION_TRANSFER_DATA_FLAG_NONE. Lihat CF_OPERATION_TRANSFER_DATA_FLAGS untuk informasi selengkapnya.

DUMMYUNIONNAME.TransferData.CompletionStatus

Status untuk mentransfer data. Ini harus diatur ke STATUS_SUCCESS jika penyedia sinkronisasi ingin mentransfer data ke file tempat penampung. Jika penyedia sinkronisasi gagal memproses permintaan hidrasi karena alasan apa pun dan tidak ingin memulai ulang hidrasi, penyedia sinkronisasi harus menetapkan status STATUS_CLOUD_FILE_* di CompletionStatus. Kode status apa pun yang dikembalikan di luar rentang STATUS_CLOUD_FILE_* kecuali untuk STATUS_SUCCESS akan dikonversi ke STATUS_CLOUD_FILE_UNSUCCESSFUL oleh platform.

DUMMYUNIONNAME.TransferData.Buffer

Buffer mode pengguna yang valid. Ini harus menunjuk ke buffer mode pengguna yang valid jika CompletionStatusSTATUS_SUCCESS dan harus memiliki setidaknya byte Panjang . Jika tidak, bidang buffer diabaikan.

DUMMYUNIONNAME.TransferData.Offset

Offset yang digunakan dengan Panjang untuk menjelaskan rentang di tempat penampung tempat data ditransfer. Ini menjelaskan rentang di tempat penampung tempat penyedia sinkronisasi mentransfer data. Tidak ada persyaratan bahwa penyedia sinkronisasi mengembalikan semua data seperti yang diminta dalam satu bidikan. Tidak masalah juga bagi penyedia sinkronisasi untuk mengembalikan lebih banyak data daripada yang diminta. Sebagai contoh, penyedia sinkronisasi dapat memutuskan untuk membaca secara berlebihan, karena performa atau alasan lainnya. Penyedia sinkronisasi juga dapat melakukan beberapa operasi TRANSFER_DATA berulang kali sebagai respons terhadap panggilan balik FETCH_DATA yang sama. Offset harus selaras 4KB.

DUMMYUNIONNAME.TransferData.Length

Panjang dalam byte Buffer. Panjangnya harus selaras 4KB kecuali rentang yang dijelaskan berakhir pada ukuran file logis (EoF), dalam hal ini, Panjang tidak diperlukan untuk selaras 4KB selama rentang yang dihasilkan berakhir pada atau di luar ukuran file logis. Bahkan jika CompletionStatus tidak STATUS_SUCCESS, bidang ini harus diatur ke nilai yang valid.

DUMMYUNIONNAME.RetrieveData

Penyedia sinkronisasi melakukan operasi RETRIEVE_DATA sebagai bagian dari hidrasi tempat penampung untuk memvalidasi integritas data yang sebelumnya ditransfer ke tempat penampung. Operasi ini dapat dilakukan sebagai respons terhadap panggilan balik FETCH_DATA , panggilan balik VALIDATE_DATA , atau sebagai bagian dari upaya hidrasi latar belakang preemptive di luar konteks panggilan balik apa pun.

API ini hanya berlaku untuk penyedia sinkronisasi yang mendukung kebijakan hidrasi yang kurang dari ALWAYS_FULL. Jika tidak, operasi akan gagal dengan STATUS_CLOUD_FILE_NOT_SUPPORTED.

Penyedia sinkronisasi diperlukan untuk menentukan pengubah kebijakan hidrasi VALIDATE_REQUIRED pada waktu pendaftaran akar sinkronisasi untuk melakukan operasi ini. Jika tidak, operasi akan gagal dengan STATUS_CLOUD_FILE_NOT_SUPPORTED.

Penyedia sinkronisasi diharuskan memiliki akses READ_DATA atau WRITE_DAC ke file tempat operasi RETRIEVE_DATA akan dilakukan. Jika tidak, operasi akan gagal dengan STATUS_CLOUD_FILE_ACCESS_DENIED.

Untuk melakukan operasi ini:

OpInfo.Type harus diatur ke CF_OPERATION_TYPE_RETRIEVE_DATA.
OpParams.ParamSize harus diatur ke ukuran OpParams.RetrieveData yang tepat ditambah offset OpParams.RetrieveData.
OpParams.RetrieveData.Flags harus diatur ke CF_OPERATION_RETRIEVE_DATA_FLAG_NONE.
OpParams.RetrieveData.Buffer harus menunjuk ke buffer mode pengguna yang valid dan setidaknya dari byte OpParams.RetrieveData.Length . Setelah berhasil menyelesaikan operasi, ia menerima data yang sebelumnya ditransfer ke tempat penampung melalui TRANSFER_DATA.
OpParams.RetrieveData.Offset dan OpParams.RetrieveData.Length menjelaskan rentang di tempat penampung tempat penyedia sinkronisasi mengambil data. Rentang yang diminta harus sepenuhnya dihidrasi oleh operasi TRANSFER_DATA sebelum operasi RETRIEVE_DATA jika tidak, operasi akan gagal dengan STATUS_CLOUD_FILE_INVALID_REQUEST. Baik offset maupun panjangnya selaras 4KB kecuali rentang yang dijelaskan berakhir pada ukuran file logis (EoF), dalam hal ini, panjangnya tidak diharuskan 4KB selaras selama berakhir pada atau di luar ukuran file logis.
OpParams.RetrieveData.ReturnedLength menerima jumlah byte aktual yang diambil setelah berhasil menyelesaikan operasi.

DUMMYUNIONNAME.RetrieveData.Flags

Bendera untuk mengambil data. Ini harus diatur ke CF_OPERATION_RETRIEVE_DATA_FLAG_NONE. Lihat CF_OPERATION_RETRIEVE_DATA_FLAGS untuk informasi selengkapnya.

DUMMYUNIONNAME.RetrieveData.Buffer

Ini harus menunjuk ke buffer mode pengguna yang valid dan setidaknya byte Panjang . Setelah berhasil menyelesaikan operasi, ia menerima data yang sebelumnya ditransfer ke tempat penampung melalui TRANSFER_DATA.

DUMMYUNIONNAME.RetrieveData.Offset

Offset yang digunakan dengan Panjang untuk menjelaskan rentang data yang diambil dari tempat penampung. Ini menjelaskan rentang di tempat penampung tempat penyedia sinkronisasi mengambil data. Rentang yang diminta harus sepenuhnya dihidrasi oleh operasi TRANSFER_DATA sebelum operasi RETRIEVE_DATA jika tidak, operasi akan gagal dengan STATUS_CLOUD_FILE_INVALID_REQUEST. Offset harus selaras 4KB.

DUMMYUNIONNAME.RetrieveData.Length

Panjang dalam byte Buffer. Ini selaras 4KB kecuali rentang yang dijelaskan berakhir pada ukuran file logis (EoF), dalam hal ini, Panjang tidak diperlukan untuk selaras 4KB selama berakhir pada atau di luar ukuran file logis.

DUMMYUNIONNAME.RetrieveData.ReturnedLength

Jumlah byte yang diambil setelah berhasil menyelesaikan operasi.

DUMMYUNIONNAME.AckData

Penyedia sinkronisasi melakukan operasi ACK_DATA sebagai bagian dari hidrasi tempat penampung setelah memvalidasi integritas data yang sebelumnya ditransfer ke platform. Operasi ini dapat dilakukan sebagai respons terhadap panggilan balik FETCH_DATA , panggilan balik VALIDATE_DATA , atau sebagai bagian dari upaya hidrasi latar belakang preemptive di luar konteks panggilan balik apa pun.

API ini hanya berlaku untuk penyedia sinkronisasi yang mendukung kebijakan hidrasi yang kurang dari ALWAYS_FULL. Jika tidak, operasi akan gagal dengan STATUS_CLOUD_FILE_NOT_SUPPORTED.

Penyedia sinkronisasi diharuskan memiliki akses READ_DATA atau WRITE_DAC ke file tempat operasi ACK_DATA akan dilakukan. Jika tidak, operasi akan gagal dengan STATUS_CLOUD_FILE_ACCESS_DENIED.

Untuk melakukan operasi ini:

OpInfo.Type harus diatur ke CF_OPERATION_TYPE_ACK_DATA.
OpParams.ParamSize harus diatur ke ukuran OpParams.AckData yang tepat ditambah OffsetOpParams.AckData.
OpParams.AckData.Flags harus diatur ke CF_OPERATION_ACK_DATA_FLAG_NONE.
OpParams.AckData.CompletionStatus harus diatur ke STATUS_SUCCESS jika penyedia sinkronisasi memvalidasi data dalam rentang yang akan diakui baik. Jika penyedia sinkronisasi gagal memvalidasi data karena alasan apa pun dan tidak ingin memulai ulang hidrasi, penyedia sinkronisasi harus mengatur status STATUS_CLOUD_FILE_* di CompletionStatus. Kode status apa pun yang dikembalikan di luar rentang STATUS_CLOUD_FILE_* kecuali untuk STATUS_SUCCESS akan dikonversi ke STATUS_CLOUD_FILE_UNSUCCESSFUL oleh platform.
OpParams.AckData.Offset dan OpParams.AckData.Length menjelaskan rentang di tempat penampung yang datanya akan diakui oleh penyedia sinkronisasi. Rentang yang diminta tidak perlu sepenuhnya dihidrasi oleh operasi TRANSFER_DATA sebelum operasi. Baik Offset maupun Panjang selaras 4KB kecuali rentang yang dijelaskan berakhir pada ukuran file logis (EoF), dalam hal ini, Panjang tidak diharuskan selaras 4KB selama berakhir pada atau di luar ukuran file logis.
Panjang-1, ditandai sebagai CF_EOF, berarti tak terbatas (yaitu hingga akhir file).

Setelah operasi ACK_DATA berhasil, setiap permintaan IO pengguna yang tertunda pada file tempat penampung yang telah menerima semua byte yang diperlukan sebagai akibat dari operasi ACK_DATA akan selesai; jika tidak, permintaan IO pengguna yang tidak lengkap akan diperbarui untuk mencerminkan status hidrasi terbaru. Dalam kasus ACK_DATA yang gagal, setiap permintaan IO pengguna yang tertunda pada file tempat penampung yang tumpang tindih dengan rentang seperti yang dijelaskan oleh Offset dan Panjang akan gagal dengan CompletionStatus.

DUMMYUNIONNAME.AckData.Flags

Bendera untuk mengakui data. Ini harus diatur ke CF_OPERATION_ACK_DATA_FLAG_NONE. Lihat CF_OPERATION_ACK_DATA_FLAGS untuk informasi selengkapnya.

DUMMYUNIONNAME.AckData.CompletionStatus

Status penyelesaian pengakuan data. Ini harus diatur ke STATUS_SUCCESS jika penyedia sinkronisasi memvalidasi data dalam rentang yang akan diakui baik. Jika penyedia sinkronisasi gagal memvalidasi data karena alasan apa pun dan tidak ingin memulai ulang hidrasi, penyedia sinkronisasi harus mengatur status STATUS_CLOUD_FILE_* di CompletionStatus. Kode status apa pun yang dikembalikan di luar rentang STATUS_CLOUD_FILE_* kecuali untuk STATUS_SUCCESS akan dikonversi ke STATUS_CLOUD_FILE_UNSUCCESSFUL oleh platform.

DUMMYUNIONNAME.AckData.Offset

Offset dalam byte data tempat penampung yang akan diakui. Offset menjelaskan rentang di tempat penampung yang datanya akan diakui oleh penyedia sinkronisasi. Rentang yang diminta tidak perlu sepenuhnya dihidrasi oleh operasi TRANSFER_DATA sebelum operasi. Offset harus selaras 4KB.

DUMMYUNIONNAME.AckData.Length

Panjang byte data di tempat penampung yang akan diakui. Harus selaras 4KB kecuali rentang yang dijelaskan berakhir pada ukuran file logis (EoF), dalam hal ini, Panjang tidak diperlukan untuk selaras 4KB selama berakhir pada atau di luar ukuran file logis. Panjang-1, ditandai sebagai CF_EOF, berarti tak terbatas (yaitu hingga akhir file).

DUMMYUNIONNAME.RestartHydration

Penyedia sinkronisasi melakukan operasi RESTART_HYDRATION untuk memulai ulang hidrasi yang sedang berlangsung. Operasi ini dapat dilakukan sebagai respons terhadap panggilan balik FETCH_DATA , panggilan balik VALIDATE_DATA , atau sebagai bagian dari upaya hidrasi latar belakang preemptive di luar konteks panggilan balik apa pun.

API ini hanya berlaku untuk penyedia sinkronisasi yang mendukung kebijakan hidrasi PENUH . Jika tidak, operasi akan gagal dengan STATUS_CLOUD_FILE_NOT_SUPPORTED.

Penyedia sinkronisasi diharuskan memiliki akses WRITE_DATA atau WRITE_DAC ke file tempat operasi RESTART_HYDRATION akan dilakukan. Jika tidak, operasi akan gagal dengan STATUS_CLOUD_FILE_ACCESS_DENIED.

Untuk melakukan operasi ini:

OpInfo.Type harus diatur ke CF_OPERATION_TYPE_RESTART_HYDRATION.
OpParams.ParamSize harus diatur ke ukuran OpParams.RestartHydration yang tepat ditambah OffsetOpParams.RestartHydration.
OpParams.RestartHydration.Flags harus diatur ke CF_OPERATION_RESTART_HYDRATION_FLAG_NONE atau CF_OPERATION_RESTART_HYDRATION_FLAG_MARK_IN_SYNC.
- Jika CF_OPERATION_RESTART_HYDRATION_FLAG_MARK_IN_SYNC ditentukan, tempat penampung akan ditandai dalam sinkronisasi setelah operasi RESTART_HYDRATION berhasil.
OpParams.RestartHydration.FsMetadata bersifat opsional. Jika disediakan:
- 0 Nilai di bidang tanda waktu (CreationTime, LastAccessTime, LastWriteTime, dan ChangeTime) berarti tidak ada perubahan pada tanda waktu saat ini pada file.
- Nilai 0 dalam FileAttributes berarti tidak ada perubahan pada atribut file saat ini pada file.
- Tidak ada nilai khusus dalam FileSize. Nilai 0 dalam FileSize memotong ukuran file menjadi 0.
OpParams.RestartHydration.FileIdentity dan OpParams.RestartHydration.FileIdentityLength bersifat opsional. Ketika disediakan, identitas baru akan tetap ada pada file. Jika tidak, identitas file saat ini tetap ada.

Penyedia sinkronisasi memanggil API ini jika menentukan data pada disk di tempat penampung sebenarnya tidak valid dan tidak cocok untuk memenuhi permintaan I/O. Skenario umumnya adalah bahwa data yang diambil karena alasan tertentu gagal dalam verifikasi checksum. Skenario penggunaan lain terjadi ketika selama hidrasi, konten file sebenarnya telah diperbarui di cloud (dan penyedia sinkronisasi tidak dapat mengambil konten historis dari cloud yang sesuai dengan versi tempat penampung lokal).

Setelah restart berhasil, tempat penampung akan sepenuhnya dehidrasi dan diperbarui dengan metadata baru, jika ada. Permintaan IO pengguna yang tertunda, jika ada, akan diolah ulang seolah-olah mereka baru saja tiba dan sebagai hasilnya, penyedia sinkronisasi akan menerima panggilan balik baru yang terlihat persis sama dengan yang diterima penyedia sinkronisasi sebelumnya.

Namun, jika hidupkan ulang gagal karena alasan apa pun, tempat penampung mungkin dibiarkan dalam status non-deterministik tergantung di mana kesalahan ditemui dan semua permintaan IO pengguna yang tertunda pada tempat penampung akan gagal dengan kesalahan yang sama. Satu-satunya hal yang dijamin platform dalam hal ini adalah bahwa akses pengguna di masa depan ke file tempat penampung akan memicu panggilan balik yang sama.

DUMMYUNIONNAME.RestartHydration.Flags

Bendera untuk memulai ulang hidrasi tempat penampung. Ini harus diatur ke CF_OPERATION_RESTART_HYDRATION_FLAG_NONE atau CF_OPERATION_RESTART_HYDRATION_FLAG_MARK_IN_SYNC. Jika CF_OPERATION_RESTART_HYDRATION_FLAG_MARK_IN_SYNC ditentukan, tempat penampung akan ditandai dalam sinkronisasi setelah operasi RESTART_HYDRATION berhasil. Lihat CF_OPERATION_RESTART_HYDRATION_FLAGS untuk informasi selengkapnya.

DUMMYUNIONNAME.RestartHydration.FsMetadata

Pilihan. Berisi pembaruan untuk metadata file. Ketika ditentukan:

0 Nilai di bidang tanda waktu (CreationTime, LastAccessTime, LastWriteTime, dan ChangeTime) berarti tidak ada perubahan pada tanda waktu saat ini pada file.
Nilai 0 dalam FileAttributes berarti tidak ada perubahan pada atribut file saat ini pada file.
Tidak ada nilai khusus dalam FileSize. Nilai 0 dalam FileSize memotong ukuran file menjadi 0.

DUMMYUNIONNAME.RestartHydration.FileIdentity

Pilihan. Ketika disediakan, identitas file diperbarui ke nilai ini. Jika tidak, tetap sama.

DUMMYUNIONNAME.RestartHydration.FileIdentityLength

Pilihan. Ini menentukan panjang FileIdentity.

DUMMYUNIONNAME.TransferPlaceholders

DUMMYUNIONNAME.TransferPlaceholders.Flags

Bendera untuk mentransfer tempat penampung. Lihat CF_OPERATION_TRANSFER_PLACEHOLDERS_FLAGS untuk informasi selengkapnya.

DUMMYUNIONNAME.TransferPlaceholders.CompletionStatus

Status penyelesaian operasi tempat penampung transfer.

DUMMYUNIONNAME.TransferPlaceholders.PlaceholderTotalCount

Jumlah total tempat penampung.

DUMMYUNIONNAME.TransferPlaceholders.PlaceholderArray

Array tempat penampung yang akan ditransfer.

DUMMYUNIONNAME.TransferPlaceholders.PlaceholderCount

Jumlah tempat penampung yang ditransfer.

DUMMYUNIONNAME.TransferPlaceholders.EntriesProcessed

Entri tempat penampung yang telah diproses.

DUMMYUNIONNAME.AckDehydrate

DUMMYUNIONNAME.AckDehydrate.Flags

Bendera pengakuan data yang didehidrasi. Lihat CF_OPERATION_ACK_DEHYDRATE_FLAGS untuk informasi selengkapnya.

DUMMYUNIONNAME.AckDehydrate.CompletionStatus

Status penyelesaian operasi dehidrasi pengakuan. Ini harus diatur ke STATUS_SUCCESS jika penyedia sinkronisasi dapat memungkinkan dehidrasi dilanjutkan. Jika penyedia sinkronisasi berniat untuk melarang dehidrasi karena alasan apa pun, penyedia sinkronisasi harus menetapkan status STATUS_CLOUD_FILE_* di CompletionStatus. Kode status apa pun yang dikembalikan di luar rentang STATUS_CLOUD_FILE_* kecuali untuk STATUS_SUCCESS akan dikonversi ke STATUS_CLOUD_FILE_UNSUCCESSFUL oleh platform.

DUMMYUNIONNAME.AckDehydrate.FileIdentity

Identitas file file tempat penampung untuk mengakui data yang didehidrasi.

DUMMYUNIONNAME.AckDehydrate.FileIdentityLength

Panjang, dalam byte, dari FileIdentity.

DUMMYUNIONNAME.AckRename

DUMMYUNIONNAME.AckRename.Flags

Mengakui ganti nama bendera tempat penampung. Lihat CF_OPERATION_ACK_RENAME_FLAGS untuk informasi selengkapnya.

DUMMYUNIONNAME.AckRename.CompletionStatus

Status penyelesaian operasi ganti nama pengakuan. Ini harus diatur ke STATUS_SUCCESS jika penyedia sinkronisasi dapat mengizinkan operasi ganti nama untuk melanjutkan. Jika penyedia sinkronisasi berniat untuk melarang penggantian nama karena alasan apa pun, penyedia sinkronisasi harus menetapkan status STATUS_CLOUD_FILE_* di CompletionStatus. Kode status apa pun yang dikembalikan di luar rentang STATUS_CLOUD_FILE_* kecuali untuk STATUS_SUCCESS akan dikonversi ke STATUS_CLOUD_FILE_UNSUCCESSFUL oleh platform.

DUMMYUNIONNAME.AckDelete

DUMMYUNIONNAME.AckDelete.Flags

Mengakui bendera penghapusan. Lihat CF_OPERATION_ACK_DELETE_FLAGS untuk informasi selengkapnya.

DUMMYUNIONNAME.AckDelete.CompletionStatus

Status penyelesaian operasi penghapusan pengakuan. Ini harus diatur ke STATUS_SUCCESS jika penyedia sinkronisasi dapat mengizinkan operasi penghapusan dilanjutkan. Jika penyedia sinkronisasi berniat untuk melarang penghapusan karena alasan apa pun, penyedia sinkronisasi harus mengatur status STATUS_CLOUD_FILE_* di CompletionStatus. Kode status apa pun yang dikembalikan di luar rentang STATUS_CLOUD_FILE_* kecuali untuk STATUS_SUCCESS akan dikonversi ke STATUS_CLOUD_FILE_UNSUCCESSFUL oleh platform.

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

CfExecute

CF_OPERATION_TRANSFER_DATA_FLAGS

CF_OPERATION_RETRIEVE_DATA_FLAGS

Bagikan melalui

struktur CF_OPERATION_PARAMETERS (cfapi.h)

Sintaks

Anggota

Persyaratan

Lihat juga

Saran dan Komentar

Sumber Daya Tambahan: