ICopyHookA

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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