PCOPYFILE2_PROGRESS_ROUTINE fungsi panggilan balik (winbase.h)

Artikel
08/27/2023

Fungsi panggilan balik yang ditentukan aplikasi yang digunakan dengan fungsi CopyFile2 . Ini dipanggil ketika sebagian operasi salinan atau pemindahan selesai. Jenis PCOPYFILE2_PROGRESS_ROUTINE menentukan penunjuk ke fungsi panggilan balik ini. CopyFile2ProgressRoutine adalah tempat penampung untuk nama fungsi yang ditentukan aplikasi.

Sintaks

PCOPYFILE2_PROGRESS_ROUTINE Pcopyfile2ProgressRoutine;

COPYFILE2_MESSAGE_ACTION Pcopyfile2ProgressRoutine(
  [in]           const COPYFILE2_MESSAGE *pMessage,
  [in, optional] PVOID pvCallbackContext
)
{...}

Parameter

[in] pMessage

Penunjuk ke struktur COPYFILE2_MESSAGE .

[in, optional] pvCallbackContext

Salinan nilai yang diteruskan di anggota pvCallbackContext dari struktur COPYFILE2_EXTENDED_PARAMETERS diteruskan ke CopyFile2.

Nilai kembali

Nilai dari enumerasi COPYFILE2_MESSAGE_ACTION yang menunjukkan tindakan apa yang harus diambil.

Mengembalikan kode/nilai	Deskripsi
COPYFILE2_PROGRESS_CONTINUE 0	Lanjutkan operasi salin.
COPYFILE2_PROGRESS_CANCEL 1	Batalkan operasi salin. Fungsi CopyFile2 akan gagal, dikembalikan `HRESULT_FROM_WIN32(ERROR_REQUEST_ABORTED)` , dan fragmen yang disalin sebagian akan dihapus.
COPYFILE2_PROGRESS_STOP 2	Hentikan operasi salin. Fungsi CopyFile2 akan gagal, kembali `HRESULT_FROM_WIN32(ERROR_REQUEST_ABORTED)` dan fragmen yang disalin sebagian akan dibiarkan utuh. Operasi dapat dimulai ulang menggunakan bendera COPY_FILE_RESUME_FROM_PAUSE hanya jika COPY_FILE_RESTARTABLE diatur dalam anggota dwCopyFlags dari struktur COPYFILE2_EXTENDED_PARAMETERS yang diteruskan ke fungsi CopyFile2 .
COPYFILE2_PROGRESS_QUIET 3	Lanjutkan operasi salin tetapi jangan panggil fungsi panggilan balik CopyFile2ProgressRoutine lagi untuk operasi ini.
COPYFILE2_PROGRESS_PAUSE 4	Jeda operasi salin. Dalam kebanyakan kasus, fungsi CopyFile2 akan gagal dan kembali `HRESULT_FROM_WIN32(ERROR_REQUEST_PAUSED)` dan fragmen yang disalin sebagian akan dibiarkan utuh (kecuali untuk header yang ditulis yang digunakan untuk melanjutkan operasi salin nanti.) Jika operasi penyalinan selesai pada saat permintaan jeda diproses, panggilan CopyFile2 akan berhasil diselesaikan dan tidak ada header resume yang akan ditulis.

Keterangan

Pesan COPYFILE2_CALLBACK_STREAM_FINISHED adalah pesan terakhir untuk salinan yang dijeda. Jika COPYFILE2_PROGRESS_PAUSE dikembalikan sebagai respons terhadap pesan COPYFILE2_CALLBACK_STREAM_FINISHED maka tidak ada panggilan balik lebih lanjut yang akan dikirim.

Untuk mengkompilasi aplikasi yang menggunakan jenis penunjuk fungsi PCOPYFILE2_PROGRESS_ROUTINE , tentukan makro _WIN32_WINNT sebagai 0x0601 atau yang lebih baru. Untuk informasi selengkapnya, lihat Menggunakan Header Windows.

Di Windows 8 dan Windows Server 2012, fungsi ini didukung oleh teknologi berikut.

Teknologi	Didukung
Protokol Server Message Block (SMB) 3.0	Ya
SMB 3.0 Transparent Failover (TFO)	Ya
SMB 3.0 dengan Berbagi File Peluasan Skala (SO)	Ya
Sistem File Volume Bersama Kluster (CsvFS)	Ya
Sistem File Tangguh (ReFS)	Ya

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8 [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows Server 2012 [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	winbase.h (termasuk Windows.h)

Share via