Antarmuka ICopyHookA (shlobj.h)

Mengekspos metode yang membuat handler hook salinan. Handler hook salinan adalah ekstensi Shell yang menentukan apakah folder Shell atau objek printer dapat dipindahkan, disalin, diganti namanya, atau dihapus. Shell memanggil metode ICopyHookA::CopyCallback sebelum melakukan salah satu operasi ini.

Warisan

Antarmuka ICopyHookA mewarisi dari antarmuka IUnknown.

Metode

Antarmuka ICopyHookA memiliki metode ini.

ICopyHookA::CopyCallback Menentukan apakah Shell akan diizinkan untuk memindahkan, menyalin, menghapus, atau mengganti nama folder atau objek printer. (ANSI)

Keterangan

Handler hook salinan, yang merupakan server dalam proses OLE (dll), tidak melakukan tugas itu sendiri, tetapi menyetujui atau tidak menyetujui tindakan. Jika Shell menerima persetujuan dari handler hook salin, Shell akan melakukan operasi sistem file. Handler hook salin tidak diberitahu tentang keberhasilan operasi, sehingga mereka tidak dapat memantau tindakan yang diambil pada objek folder kecuali FindFirstChangeNotification digunakan.

Objek folder dapat memiliki beberapa handler hook salinan. Misalnya, bahkan jika Shell sudah memiliki handler kait salinan yang terdaftar untuk objek folder tertentu, Anda masih dapat mendaftarkan salah satu dari Anda sendiri. Jika dua atau lebih handler hook salin terdaftar untuk objek, Shell hanya memanggil masing-masing sebelum melakukan salah satu operasi sistem file yang ditentukan.

Shell menginisialisasi ICopyHookA secara langsung, tanpa menggunakan antarmuka IShellExtInit terlebih dahulu.

CopyCallback mengembalikan nilai int yang menunjukkan apakah Shell harus melakukan operasi. Shell akan memanggil setiap handler hook salinan yang terdaftar untuk objek folder sampai semua handler telah dipanggil atau sampai salah satunya mengembalikan nilai selain IDYES. Handler mengembalikan IDYES untuk menentukan bahwa operasi harus dilakukan, atau IDNO atau IDCANCEL untuk menentukan bahwa operasi harus dihentikan.

Terapkan handler hook salinan ketika Anda ingin dapat mengontrol kapan, atau jika, operasi sistem file ini dilakukan pada objek tertentu. Anda mungkin ingin menggunakan handler hook salin pada folder bersama, misalnya.

Anda tidak memanggil ekstensi Shell ini secara langsung. CopyCallback dipanggil oleh Shell sebelum memindahkan, menyalin, menghapus, atau mengganti nama objek folder Shell.

Catatan

Header shlobj.h mendefinisikan ICopyHook sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Header	shlobj.h