Метод IStorageProviderCopyHook::CopyCallback

Определяет, разрешено ли оболочке перемещать, копировать, удалять или переименовывать папку в корневом каталоге синхронизации поставщика облачных служб.

Синтаксис

HRESULT CopyCallback( 
    HWND hwnd,
    UINT operation,
    UINT flags,
    LPCWSTR srcFile,
    DWORD srcAttribs,
    LPCWSTR destFile,
    DWORD destAttribs,
    UINT* result
);

Параметры

hwnd [in]

Дескриптор окна, который обработчик перехватчика копирования должен использовать в качестве родительского элемента для всех элементов пользовательского интерфейса, которые может потребоваться отобразить обработчику. Если FOF_SILENT указан в операции, метод должен игнорировать этот параметр.

операция [in]

Выполняемая операция. Этот параметр может быть одним из значений, перечисленных в элементе wFunc структуры SHFILEOPSTRUCT .

flags [in]

Флаги, управляющие операцией. Этот параметр может быть одним или несколькими значениями, перечисленными в элементе fFlags структуры SHFILEOPSTRUCT .

Для перехватчиков копирования принтера это значение является одним из следующих значений, определенных в shellapi.h.

Значение	Описание
PO_DELETE	Принтер удаляется. Параметр srcFile указывает на полный путь к указанному принтеру.
PO_RENAME	Принтер переименовываются. Параметр srcFile указывает на новое имя принтера. Параметр destFile указывает на старое имя.
PO_PORTCHANGE	Не поддерживается. Не используйте.
PO_REN_PORT	Не поддерживается. Не используйте.

srcFile [in]

Указатель на строку, содержащую имя исходной папки.

srcAttribs [in]

Атрибуты исходной папки. Этот параметр может быть сочетанием любых флагов атрибутов файла (FILE_ATTRIBUTE_*), определенных в файлах заголовков. См. раздел Константы атрибутов файлов.

destFile [in]

Указатель на строку, содержащую имя конечной папки.

destAttribs [in]

Атрибуты конечной папки. Этот параметр может быть сочетанием любых флагов атрибутов файла (FILE_ATTRIBUTE_*), определенных в файлах заголовков. См. раздел Константы атрибутов файлов.

result [out]

Целочисленное значение, указывающее, должна ли оболочка выполнять операцию. Это может быть:

Значение	Описание
IDYES	Разрешает операцию .
IDNO	Запрещает операцию с этой папкой, но продолжается с другими утвержденными операциями (например, пакетной операцией копирования).
IDCANCEL	Предотвращает текущую операцию и отменяет все ожидающие операции.

Возвращаемое значение

Возвращает S_OK в случае успешного выполнения, или код ошибки в противном случае.

Комментарии

Оболочка вызывает обработчик перехватчика копирования поставщика облачных служб для каждой папки в зарегистрированной корневой папке синхронизации. Чтобы зарегистрировать обработчик перехватчика копирования для облачных папок, задайте значение CopyHook в разделе HKEY_LOCAL_MACHINE/Software/Microsoft/Windows/CurrentVersion/Обозреватель/SyncRootManager/{SyncRootId}, значение CLSID объекта перехватчика копирования.

При вызове метода CopyCallback оболочка инициализирует интерфейс IStorageProviderCopyHook напрямую без использования интерфейса IShellExtInit .

Требования

Требование	Значение
Минимальная версия клиента	сборка Windows 10 Insider Preview 19624
Заголовок	shobjidl.h

См. также раздел

Создание облачной подсистемы синхронизации, поддерживающей файлы заполнителей