enumerasi COPYFILE2_MESSAGE_ACTION (winbase.h)
Dikembalikan oleh fungsi panggilan balik CopyFile2ProgressRoutine untuk menunjukkan tindakan apa yang harus diambil untuk operasi penyalinan yang tertunda.
Sintaks
typedef enum _COPYFILE2_MESSAGE_ACTION {
COPYFILE2_PROGRESS_CONTINUE = 0,
COPYFILE2_PROGRESS_CANCEL,
COPYFILE2_PROGRESS_STOP,
COPYFILE2_PROGRESS_QUIET,
COPYFILE2_PROGRESS_PAUSE
} COPYFILE2_MESSAGE_ACTION;
Konstanta
COPYFILE2_PROGRESS_CONTINUE Nilai: 0 Lanjutkan operasi salin. |
COPYFILE2_PROGRESS_CANCEL Batalkan operasi salin. Panggilan CopyFile2 akan gagal dan kembali HRESULT_FROM_WIN32(ERROR_REQUEST_ABORTED) danfragmen yang disalin sebagian akan dihapus. |
COPYFILE2_PROGRESS_STOP Hentikan operasi salin. Panggilan CopyFile2 akan gagal dan kembali HRESULT_FROM_WIN32(ERROR_REQUEST_ABORTED) danfragmen yang disalin sebagian akan dibiarkan utuh. Operasi dapat dimulai ulang menggunakan COPY_FILE_RESUME_FROM_PAUSE bendera hanya jika bendera COPY_FILE_RESTARTABLE diatur dalam dwCopyFlags anggota dari struktur COPYFILE2_EXTENDED_PARAMETERS diteruskan ke fungsi CopyFile2 . |
COPYFILE2_PROGRESS_QUIET Lanjutkan operasi salin tetapi jangan panggil Fungsi panggilan balik CopyFile2ProgressRoutine lagi untuk operasi ini. |
COPYFILE2_PROGRESS_PAUSE Jeda operasi salin dan tulis header hidupkan ulang. Nilai ini tidak kompatibel dengan COPY_FILE_RESTARTABLE bendera untuk anggota dwCopyFlags COPYFILE2_EXTENDED_PARAMETERS Struktur. Dalam kebanyakan kasus, panggilan CopyFile2 akan gagal dan return HRESULT_FROM_WIN32(ERROR_REQUEST_PAUSED) dan anyfragmen yang disalin sebagian akan dibiarkan utuh (kecuali untuk header yang ditulis yang digunakan untuk melanjutkan salinan operasi nanti.) Jika operasi penyalinan selesai pada saat permintaan jeda diproses Panggilan CopyFile2 akan berhasil diselesaikan dan tidak ada resume header akan ditulis. Setelah nilai ini diproses satu panggilan balik lagi akan dilakukan ke CopyFile2ProgressRoutine dengan pesan menentukan nilai COPYFILE2_CALLBACK_STREAM_FINISHED (4) dalam Jenis anggota dari COPYFILE2_MESSAGE struktur. Setelah panggilan balik memiliki CopyFile2 yang dikembalikan akan gagal dengan HRESULT_FROM_WIN32(ERROR_REQUEST_PAUSED) . |
Keterangan
Untuk mengkompilasi aplikasi yang menggunakan enumerasi ini, tentukan makro _WIN32_WINNT sebagai 0x0601 atau yang lebih baru. Untuk informasi selengkapnya, lihat Menggunakan Header Windows.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows 8 [aplikasi desktop | Aplikasi UWP] |
Server minimum yang didukung | Windows Server 2012 [aplikasi desktop | Aplikasi UWP] |
Header | winbase.h (termasuk Windows.h) |
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk