Метод ICopyHookW::CopyCallback (shlobj.h)
Определяет, будет ли оболочке разрешено перемещать, копировать, удалять или переименовывать объект папки или принтера.
Синтаксис
UINT CopyCallback(
HWND hwnd,
UINT wFunc,
UINT wFlags,
PCWSTR pszSrcFile,
DWORD dwSrcAttribs,
PCWSTR pszDestFile,
DWORD dwDestAttribs
);
Параметры
hwnd
Дескриптор окна, который обработчик перехватчика копирования должен использовать в качестве родительского элемента для любых элементов пользовательского интерфейса, которые обработчик может потребоваться отобразить. Если FOF_SILENT указано в wFunc, метод должен игнорировать этот параметр.
wFunc
Выполняемая операция. Этот параметр может быть одним из значений, перечисленных в элементе wFunc структуры SHFILEOPSTRUCT .
wFlags
Флаги, управляющие операцией. Этот параметр может иметь одно или несколько значений, перечисленных в элементе fFlags структуры SHFILEOPSTRUCT .
Для перехватчиков копирования принтера это значение является одним из следующих значений, определенных в Shellapi.h.
Значение | Описание |
---|---|
PO_DELETE | Принтер удаляется. pszSrcFile указывает на полный путь к указанному принтеру. |
PO_RENAME | Принтер переименовываются. Параметр pszSrcFile указывает на новое имя принтера. Параметр pszDestFile указывает на старое имя. |
PO_PORTCHANGE | Не поддерживается. Не используйте. |
PO_REN_PORT | Не поддерживается. Не используйте. |
pszSrcFile
Указатель на строку, содержащую имя исходной папки.
dwSrcAttribs
Атрибуты исходной папки. Этот параметр может быть сочетанием любого флага атрибута файла (FILE_ATTRIBUTE_*), определенных в файлах заголовков. См. раздел Константы атрибутов файлов.
pszDestFile
Указатель на строку, содержащую имя конечной папки.
dwDestAttribs
Атрибуты конечной папки. Этот параметр может быть сочетанием любого флага атрибута файла (FILE_ATTRIBUTE_*), определенных в файлах заголовков. См. раздел Константы атрибутов файлов.
Возвращаемое значение
Возвращает целочисленное значение, указывающее, должна ли оболочка выполнять операцию. Это может быть:
Значение | Описание |
---|---|
IDYES | Разрешает операцию. |
IDNO | Запрещает операцию с этой папкой, но продолжается с другими утвержденными операциями (например, операцией пакетного копирования). |
IDCANCEL | Предотвращает текущую операцию и отменяет все ожидающие операции. |
Комментарии
Оболочка вызывает каждый обработчик перехватчика копирования, зарегистрированный для объекта папки или принтера, пока не будут вызваны все обработчики или пока один из них не вернет IDNO или IDCANCEL.
Обработчики перехватчиков копирования для папок регистрируются под следующим ключом:
HKEY_CLASSES_ROOT/Directory/Shellex/CopyHookHandlers/your_copyhook/{значение CLSID copyhook}
Обработчики перехватчиков копирования для принтеров регистрируются в следующем ключе.
HKEY_CLASSES_ROOT/Printers/Shellex/CopyHookHandlers/your_copyhook/{значение CLSID copyhook}
При вызове этого метода оболочка инициализирует интерфейс ICopyHookW напрямую без использования интерфейса IShellExtInit .
Требования
Требование | Значение |
---|---|
Заголовок | shlobj.h |