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

  • [アーティクル]

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

構文

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

パラメーター

hwnd

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

wFunc

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

wFlags

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

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

値 説明
PO_DELETE プリンターが削除されています。 pszSrcFile は 、指定されたプリンターへの完全パスを指します。
PO_RENAME プリンターの名前が変更されています。 pszSrcFile パラメーターは、プリンターの新しい名前を指します。 pszDestFile パラメーターは、古い名前を指します。
PO_PORTCHANGE サポートされていません。 使用しないでください。
PO_REN_PORT サポートされていません。 使用しないでください。

pszSrcFile

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

dwSrcAttribs

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

pszDestFile

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

dwDestAttribs

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

戻り値

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

値 説明
IDYES 操作を許可します。
IDNO このフォルダーに対する操作を禁止しますが、承認されたその他の操作 (バッチ コピー操作など) を続行します。
IDCANCEL 現在の操作を禁止し、保留中の操作をすべて取り消します。

注釈

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

要件

要件 値
Header shlobj.h