Bagikan melalui


enumerasi CF_OPERATION_TRANSFER_PLACEHOLDERS_FLAGS (cfapi.h)

Bendera untuk menentukan perilaku saat mentransfer file atau direktori tempat penampung.

Syntax

typedef enum CF_OPERATION_TRANSFER_PLACEHOLDERS_FLAGS {
  CF_OPERATION_TRANSFER_PLACEHOLDERS_FLAG_NONE = 0x00000000,
  CF_OPERATION_TRANSFER_PLACEHOLDERS_FLAG_STOP_ON_ERROR = 0x00000001,
  CF_OPERATION_TRANSFER_PLACEHOLDERS_FLAG_DISABLE_ON_DEMAND_POPULATION = 0x00000002
} ;

Constants

 
CF_OPERATION_TRANSFER_PLACEHOLDERS_FLAG_NONE
Nilai: 0x00000000
Tidak ada bendera tempat penampung transfer.
CF_OPERATION_TRANSFER_PLACEHOLDERS_FLAG_STOP_ON_ERROR
Nilai: 0x00000001
Menyebabkan API segera kembali jika transfer tempat penampung gagal. Jika transfer gagal, kode kesalahan akan dikembalikan.
CF_OPERATION_TRANSFER_PLACEHOLDERS_FLAG_DISABLE_ON_DEMAND_POPULATION
Nilai: 0x00000002
Menonaktifkan populasi sesuai permintaan untuk direktori, mencegah panggilan balik CF_CALLBACK_TYPE_FETCH_PLACEHOLDERS lebih lanjut.

PENTING

Tanpa bendera ini, panggilan balik tempat penampung transfer akan dipanggil berulang kali (berpotensi 100+ kali) karena sistem terus meminta tempat penampung sesuai permintaan. Penyedia harus mengatur bendera ini untuk menunjukkan bahwa semua tempat penampung telah dibuat dan tidak diperlukan panggilan balik lebih lanjut.

Setelah penyedia selesai membuat semua tempat penampung dalam direktori, penyedia harus menandai direktori sebagai sepenuhnya diisi dengan mengatur bendera CF_OPERATION_TRANSFER_PLACEHOLDERS_FLAG_DISABLE_ON_DEMAND_POPULATION . Ini mencegah panggilan balik CF_CALLBACK_TYPE_FETCH_PLACEHOLDERS dipanggil lagi untuk direktori tersebut. Biasanya, penyedia harus mengatur bendera ini setelah meletakkan semua tempat penampung di direktori, atau jika pemanggilan CF_OPERATION_TYPE_TRANSFER_PLACEHOLDERS saat ini seharusnya membuat semua tempat penampung yang tersisa.

Penyedia dapat mengatur bendera ini kapan saja dan akan dihormati oleh platform jika selama pemanggilan CF_OPERATION_TYPE_TRANSFER_PLACEHOLDERS saat ini:

1. TransferPlaceholders.PlaceholderTotalCount<= (Jumlah Sebelumnya TransferPlaceholders.EntriesProcessed) + Saat Ini TransferPlaceholders.PlaceholderCount.
1. Semua tempat penampung saat ini TransferPlaceholders.PlaceholderCount berhasil dibuat.

Misalnya, jika penyedia harus mentransfer sepuluh tempat penampung, penyedia dapat mentransfer dan mengatur CF_OPERATION_TRANSFER_PLACEHOLDERS_FLAG_DISABLE_ON_DEMAND_POPULATION dengan salah satu cara berikut.

Ini bisa melakukan ini:

1. Atur TransferPlaceholders.PlaceholderTotalCount = 5, atur TransferPlaceholders.PlaceholderCount4 = , dan atur Flags ke .NONE
1. Atur TransferPlaceholders.PlaceholderTotalCount = 9, atur TransferPlaceholders.PlaceholderCount4 = , dan atur Flags ke .NONE
1. Atur TransferPlaceholders.PlaceholderTotalCount = 11, atur TransferPlaceholders.PlaceholderCount2 = , dan atur Flags ke .NONE
1. Atur TransferPlaceholders.PlaceholderTotalCount = 10, atur TransferPlaceholders.PlaceholderCount0 = , dan atur Flags ke .CF_OPERATION_TRANSFER_PLACEHOLDERS_FLAG_DISABLE_ON_DEMAND_POPULATION

Atau dapat melakukan hal berikut:

1. Atur TransferPlaceholders.PlaceholderTotalCount = 5, atur TransferPlaceholders.PlaceholderCount4 = , dan atur Flags ke .NONE
1. Atur TransferPlaceholders.PlaceholderTotalCount = 9, atur TransferPlaceholders.PlaceholderCount4 = , dan atur Flags ke .NONE
1. Atur TransferPlaceholders.PlaceholderTotalCount = 10, atur TransferPlaceholders.PlaceholderCount2 = , dan atur Flags ke .CF_OPERATION_TRANSFER_PLACEHOLDERS_FLAG_DISABLE_ON_DEMAND_POPULATION

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_TYPE

CF_OPERATION_TYPE

CfExecute