На главную

On-line справка по Win32 API

Написать письмо
БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!
Список всех статей A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать Вниз

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.



Пригласи друзей и счет твоего мобильника всегда будет положительным!
Предыдущая статья
 
Сайт Народ.Ру Интернет
Следующая статья
Пригласи друзей и счет твоего мобильника всегда будет положительным!

ICopyHook



Интерфейс ICopyHook является базирующимся интерфейсом COM использованным, чтобы создавать рычажного вручителя копии, расширение оболочки, которые определяют независимо это хорошо должно перемещать, копировать, переименовывать, или удалять папку оболочки или объекта принтера. Оболочка называет ICopyHook::CopyCallback до выполнения одно из этих действий.

Рычажный вручитель копии, который - сервер изготовления OLE ( DLL), не выполняет саму задачу но одобряет или осуждает действие. Если оболочка получает одобрение из рычажного вручителя копии, она выполняет файловую системную операцию. Рычажные вручители Копии не сообщены об успехе операции, так что не мочь проверить действия принятые на объекты папки, кроме через FindFirstChangeNotify.
Объект папки может иметь рычажных вручителей многочисленной копии. Например, даже если бы оболочка уже имеет рычажного вручителя копии регистрировался для конкретного объекта папки, Вы можете все еще зарегистрировать одно из ваш собственный. Если два или более рычажные вручители копии зарегистрированы для объекта, оболочка просто называет каждый из их перед выполнением один определенные файловые системные операции.

Оболочка инициализирует ICopyHook непосредственно, не используя IShellExtInit или интерфейсы IPersistFile сначала.
CopyCallback ВОЗВРАЩАЕТ величину целого, которая указывает должна оболочка выполнить операцию. Оболочка назовет каждый рычажный вручитель копия зарегистрированное для объект папка до или все вручители назван или один из них возвращал величину кроме IDYES. Вручитель может также возвращать IDYES, чтобы определять, что операция будет выполнена, или IDNO или IDCANCEL, чтобы определять, что операция будет прекращена.

Когда, чтобы Осуществляться

Осуществите рычажного вручителя копии, например для коллективных папок, когда Вы хотите быть способными управлять когда, или if. эти файловые системные операции выполнены на данном объекте.

Когда, чтобы Использоваться

Вы не называете это расширение оболочки непосредственно. ICopyHook::CopyCallback НАЗВАН оболочкой до перемещение, копирующей, переименование, или удаляя объект папки оболочки.

Методы в Порядке Vtable

ВОЗВРАТ Методов IUnknown указателей Description QueryInterface на поддерживал интерфейсы.
AddRef УВЕЛИЧИВАЕТ счет ссылки.
Счет ссылки Декрементов Версии.


ОПИСАНИЕ Методов ICopyHook
CopyCallback ОПРЕДЕЛЯЕТ независимо перемещение, копия, удалять, или переименовывать операцию на объект папки должно быть допущено или отвергнуто.



Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz