ICopyHookW::Metode CopyCallback (shlobj.h)

Artikel
03/04/2024

Menentukan apakah Shell akan diizinkan untuk memindahkan, menyalin, menghapus, atau mengganti nama folder atau objek printer.

Sintaks

UINT CopyCallback(
  HWND   hwnd,
  UINT   wFunc,
  UINT   wFlags,
  PCWSTR pszSrcFile,
  DWORD  dwSrcAttribs,
  PCWSTR pszDestFile,
  DWORD  dwDestAttribs
);

Parameter

hwnd

Handel ke jendela yang harus digunakan handler hook salinan sebagai induk untuk elemen antarmuka pengguna apa pun yang mungkin perlu ditampilkan oleh handler. Jika FOF_SILENT ditentukan dalam wFunc, metode harus mengabaikan parameter ini.

wFunc

Operasi yang akan dilakukan. Parameter ini dapat menjadi salah satu nilai yang tercantum di bawah anggota wFunc struktur SHFILEOPSTRUCT .

wFlags

Bendera yang mengontrol operasi. Parameter ini dapat berupa satu atau beberapa nilai yang tercantum di bawah anggota fFlags dari struktur SHFILEOPSTRUCT .

Untuk hook salinan printer, nilai ini adalah salah satu nilai berikut yang ditentukan dalam Shellapi.h.

Nilai	Deskripsi
PO_DELETE	Pencetak sedang dihapus. pszSrcFile menunjuk ke jalur lengkap ke printer yang ditentukan.
PO_RENAME	Printer sedang diganti namanya. Parameter pszSrcFile menunjuk ke nama baru printer. Parameter pszDestFile menunjuk ke nama lama.
PO_PORTCHANGE	Tidak didukung. Jangan gunakan.
PO_REN_PORT	Tidak didukung. Jangan gunakan.

pszSrcFile

Penunjuk ke string yang berisi nama folder sumber.

dwSrcAttribs

Atribut folder sumber. Parameter ini dapat menjadi kombinasi dari salah satu bendera atribut file (FILE_ATTRIBUTE_*) yang ditentukan dalam file header. Lihat Konstanta Atribut File.

pszDestFile

Penunjuk ke string yang berisi nama folder tujuan.

dwDestAttribs

Atribut folder tujuan. Parameter ini dapat menjadi kombinasi dari salah satu bendera atribut file (FILE_ATTRIBUTE_*) yang ditentukan dalam file header. Lihat Konstanta Atribut File.

Mengembalikan nilai

Mengembalikan nilai bilangan bulat yang menunjukkan apakah Shell harus melakukan operasi. Salah satu dari berikut ini:

Nilai	Deskripsi
IDYES	Memungkinkan operasi.
IDNO	Mencegah operasi pada folder ini tetapi berlanjut dengan operasi lain yang telah disetujui (misalnya, operasi salinan batch).
IDCANCEL	Mencegah operasi saat ini dan membatalkan operasi yang tertunda.

Keterangan

Shell memanggil setiap handler hook salinan yang terdaftar untuk folder atau objek printer hingga semua handler dipanggil, atau sampai salah satunya mengembalikan IDNO atau IDCANCEL.

Handler hook salin untuk folder terdaftar di bawah kunci berikut:

HKEY_CLASSES_ROOT/Directory/Shellex/CopyHookHandlers/your_copyhook/{copyhook CLSID value}

Handler kait salin untuk printer terdaftar di bawah kunci berikut.

HKEY_CLASSES_ROOT/Printers/Shellex/CopyHookHandlers/your_copyhook/{copyhook CLSID value}

Ketika metode ini dipanggil, Shell menginisialisasi antarmuka ICopyHookW secara langsung tanpa menggunakan antarmuka IShellExtInit terlebih dahulu.

Persyaratan

Persyaratan	Nilai
Header	shlobj.h

Bagikan melalui