|
ICopyHook
The ICopyHook interface is a COM-based interface used to create a copy hook handler, a
shell extension, that determines whether it is all right to move, copy, rename, or
delete a shell folder or printer object. The shell calls ICopyHook::CopyCallback prior to performing one of these operations.
The copy hook handler, which is an OLE in-process server (a DLL), does not
perform the task itself, but does approve or disapprove the action. If the shell
receives approval from the copy hook handler, it performs the file system
operation. Copy hook handlers are not informed about the success of an operation, so
cannot monitor actions taken on folder objects, except via FindFirstChangeNotify.
A folder object can have multiple copy hook handlers. For example, even if the
shell already has a copy hook handler registered for a particular folder
object, you can still register one of your own. If two or more copy hook handlers
are registered for an object, the shell simply calls each of them before
performing one the specified file system operations.
The shell initializes ICopyHook directly, without using the IShellExtInit or IPersistFile interfaces first.
CopyCallback returns an integer value that indicates whether or not the shell should
perform the operation. The shell will call each copy hook handler registered for a
folder object until either all the handlers have been called or one of them has
returned a value other than IDYES. The handler can also return IDYES to specify
that the operation should be performed, or IDNO or IDCANCEL to specify that
the operation should be discontinued.
When to Implement
Implement a copy hook handler, for example for shared folders, when you want
to be able to control when, or if. these file system operations are performed on
a given object.
When to Use
You don't call this shell extension directly. ICopyHook::CopyCallback is called by the shell prior to moving, copying, renaming, or deleting a
shell folder object.
Methods in Vtable Order
IUnknown Methods
| Description
| QueryInterface
| Returns pointers to supported interfaces.
| AddRef
| Increments reference count.
| Release
| Decrements reference count.
|
ICopyHook Methods
| Description
| CopyCallback
| Determines whether a move, copy, delete, or rename operation on a folder
object should be allowed or disallowed.
|
| Last news from Greatis Software |
 |
|
Nostalgia .Net |
|
.Net is powerful, but not all-powerful, so sometimes we need to use Win32 API for our .Net applications. It's simple enough with Platform Invoke if you have Win32 skill, but we do not always have time to dig the ancient documentation, declare the special types that are compatible with Win32, find the values of the Win32's constants and so on. Nostalgia .Net offers several simple-to-use classes, and components that will allow you to forget about the headache of Win32 and just use the power of Win32 in your application the same way as you use the native. Net classes. More » |
| Recommended software for developers |
 |
|
Ultimate Pack |
|
Component pack for Delphi and C++ Builder that contains runtime form designer, runtime object inspector, print suite and much more for the very special price. More » |
 |
|
Form Designer .Net |
|
Unique runtime form design solution that allows to edit any form in .Net WinForms application at runtime with full source codes for only 300 euro! More » |
 |
|
Print Suite .Net |
|
Print Suite .Net is a set of components for easy printing texts, images and grids from your WinForms applications. Full C# source codes are available More » |
 |
|
Gradient Controls .Net |
|
Gradient Controls .Net offers controls with gradient background feature. Labels, panels and so on... Full C# source codes are available More » |
 |
|
Greatis iGrid |
|
iGrid plots drawing grid right over your desktop, so you can use it everywhere, with any drawing application without any special plugins for different graphic editors. More » |
All the contacts and projectsDmitry Vasiliev (just.dmitry)
Related LinksSoftware for Visual Studio .NET developers Software for Delphi and C++ Builder developers Software for Visual Basic 6 developers Delphi Tips&Tricks MegaDetailed.NET More Online Helps Win32 Programmer's Reference Win32 Multimedia Programmer's Reference OLE Programmer's Reference Microsoft Windows Pen API Programmer's Reference Microsoft Windows Sockets 2 Reference Microsoft Windows Telephony API (TAPI) Programmer's Reference Unix Manual Pages
|