ICopyHookA::CopyCallback メソッド (shlobj.h)

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

構文

UINT CopyCallback(
  HWND  hwnd,
  UINT  wFunc,
  UINT  wFlags,
  PCSTR pszSrcFile,
  DWORD dwSrcAttribs,
  PCSTR pszDestFile,
  DWORD dwDestAttribs
);

パラメーター

hwnd

コピー フック ハンドラーが、ハンドラーが表示する必要があるユーザー インターフェイス要素の親として使用する必要があるウィンドウへのハンドル。 wFunc で FOF_SILENTが指定されている場合、メソッドはこのパラメーターを無視する必要があります。

wFunc

実行する操作。 このパラメーターには、SHFILEOPSTRUCT 構造体の wFunc メンバーの下にリストされている値のいずれかを指定できます。

wFlags

操作を制御するフラグ。 このパラメーターには、SHFILEOPSTRUCT 構造体の fFlags メンバーの下にリストされている 1 つ以上の値を指定できます。

プリンター コピー フックの場合、この値は Shellapi.h で定義されている次のいずれかの値です。

pszSrcFile

ソース フォルダーの名前を含む文字列へのポインター。

dwSrcAttribs

ソース フォルダーの属性。 このパラメーターには、ヘッダー ファイルで定義されている任意のファイル属性フラグ (FILE_ATTRIBUTE_*) の組み合わせを指定できます。 「ファイル属性定数」を参照してください。

pszDestFile

コピー先フォルダーの名前を含む文字列へのポインター。

dwDestAttribs

移動先フォルダーの属性。 このパラメーターには、ヘッダー ファイルで定義されている任意のファイル属性フラグ (FILE_ATTRIBUTE_*) の組み合わせを指定できます。 「ファイル属性定数」を参照してください。

戻り値

シェルが操作を実行する必要があるかどうかを示す整数値を返します。 次のいずれかになります。

注釈

シェルは、すべてのハンドラーが呼び出されるまで、またはいずれかのハンドラーが 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 インターフェイスが直接初期化されます。

要件