Поделиться через


Метод 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