Bagikan melalui

enumerasi COPYFILE2_MESSAGE_ACTION (winbase.h)

  • Artikel

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) dan
fragmen yang disalin sebagian akan dihapus.
COPYFILE2_PROGRESS_STOP
Hentikan operasi salin. Panggilan CopyFile2 akan gagal
dan kembali HRESULT_FROM_WIN32(ERROR_REQUEST_ABORTED) dan
fragmen 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 any
fragmen 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

CopyFile2

CopyFile2ProgressRoutine

Enumerasi Manajemen File