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]
-
수행할 작업입니다. 이 매개 변수는 SHFILEOPSTRUCT 구조체의 wFunc 멤버 아래에 나열된 값 중 하나일 수 있습니다.
-
flags [in]
-
작업을 제어하는 플래그입니다. 이 매개 변수는 SHFILEOPSTRUCT 구조체의 fFlags 멤버 아래에 나열된 값 중 하나 이상일 수 있습니다.
프린터 복사 후크의 경우 이 값은 shellapi.h에 정의된 다음 값 중 하나입니다.
값 Description 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 반환하고, 그렇지 않으면 오류 코드를 반환합니다.
설명
Shell은 등록된 동기화 루트 아래의 모든 폴더에 대해 클라우드 공급자의 복사 후크 처리기를 호출합니다. 클라우드 폴더에 대한 복사 후크 처리기를 등록하려면 HKEY_LOCAL_MACHINE/Software/Microsoft/Windows/CurrentVersion/Explorer/SyncRootManager/{SyncRootId} 키 아래의 CopyHook 값을 복사 후크 개체의 CLSID로 설정합니다.
CopyCallback 메서드가 호출되면 Shell은 먼저 IShellExtInit 인터페이스를 사용하지 않고 IStorageProviderCopyHook 인터페이스를 직접 초기화합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 10 Insider Preview 빌드 19624 |
| 헤더 | shobjidl.h |