ICopyHookW

コピーフックハンドラーを作成するメソッドを公開します。(Unicode)

コピーフックハンドラーは OLE のインプロセスサーバー(dll)であり、処理自体を実行するわけではなく、その操作を承認または拒否します。Shell はコピーフックハンドラーから承認を得た場合に、ファイルシステム操作を実行します。コピーフックハンドラーには操作の成否が通知されないため、FindFirstChangeNotification を使用しない限り、フォルダーオブジェクトに対して行われた処理を監視することはできません。

1 つのフォルダーオブジェクトには複数のコピーフックハンドラーを設定できます。たとえば、特定のフォルダーオブジェクトに対して Shell が既にコピーフックハンドラーを登録している場合でも、独自のハンドラーを追加登録できます。1 つのオブジェクトに対して 2 つ以上のコピーフックハンドラーが登録されている場合、Shell は指定されたファイルシステム操作を実行する前に、それぞれのハンドラーを順に呼び出します。

Shell は、まず IShellExtInit インターフェイスを使用することなく、ICopyHookA を直接初期化します。

CopyCallback は、Shell が操作を実行すべきかどうかを示す int 値を返します。Shell は、フォルダーオブジェクトに登録されたすべてのコピーフックハンドラーを呼び出すか、あるいはいずれかのハンドラーが IDYES 以外の値を返すまで、各ハンドラーを呼び出します。ハンドラーは、操作を実行すべき場合は IDYES を返し、操作を中止すべき場合は IDNO または IDCANCEL を返します。

これらのファイルシステム操作を特定のオブジェクトに対していつ実行するか、あるいは実行するかどうかを制御したい場合に、コピーフックハンドラーを実装します。たとえば、共有フォルダーに対してコピーフックハンドラーを使用するとよいでしょう。

この Shell 拡張機能を直接呼び出すことはありません。CopyCallback は、Shell フォルダーオブジェクトの移動、コピー、削除、または名前変更の直前に Shell によって呼び出されます。

Shell がフォルダーまたはプリンターオブジェクトの移動、コピー、削除、または名前変更を許可するかどうかを判断します。(Unicode)

Shell が操作を実行すべきかどうかを示す整数値を返します。次のいずれかです。

Shell は、フォルダーまたはプリンターオブジェクトに登録されたすべてのコピーフックハンドラーを呼び出すか、あるいはいずれかのハンドラーが IDNO または IDCANCEL を返すまで、各ハンドラーを呼び出します。

フォルダー用のコピーフックハンドラーは、次のキーの下に登録されます。

HKEY_CLASSES_ROOT/Directory/Shellex/CopyHookHandlers/your_copyhook/{copyhook CLSID value}

プリンター用のコピーフックハンドラーは、次のキーの下に登録されます。

HKEY_CLASSES_ROOT/Printers/Shellex/CopyHookHandlers/your_copyhook/{copyhook CLSID value}

このメソッドが呼び出されると、Shell はまず IShellExtInit インターフェイスを使用することなく、ICopyHookW インターフェイスを直接初期化します。