ITransferAdviseSink::FileFailure メソッド (shobjidl_core.h)

  • [アーティクル]

エラーが発生し、ユーザー操作が必要な場合に呼び出されます。

構文

HRESULT FileFailure(
  [in]      IShellItem *psi,
  [in]      LPCWSTR    pszItem,
  [in]      HRESULT    hrError,
  [in, out] LPWSTR     pszRename,
  [in]      ULONG      cchRename
);

パラメーター

[in] psi

種類: IShellItem*

操作が失敗した IShellItem 。

[in] pszItem

種類: LPCWSTR

省略可能。 ファイルの名前を含む null で終わるバッファーへのポインター。 この値が NULL の場合は、 psi パラメーターによって指定された名前が使用されます。

[in] hrError

型: HRESULT

エラーによって生成されたエラー コード。 このエラーは、コピー エンジンで処理する必要があります。

[in, out] pszRename

種類: LPWSTR

省略可能。 このメソッドが戻るときに、 には、ファイルの新しい名前を含む null で終わるバッファーへのポインターが含まれます。 名前は 長さ cchRename を超えることはできません。 このパラメーターが NULL の場合、名前を変更するオプションは使用できません。

[in] cchRename

種類: ULONG

pszRename バッファーのサイズ (文字数)。

戻り値

型: HRESULT

その他の HRESULT は、呼び出し元プロセスに返す必要があります。 エラーが処理されない場合、戻り値は hrError である必要があります。

リターン コード 説明
COPYENGINE_S_USER_RETRY
 ユーザーが [ 再試行] をクリックしました。 ハンドラーは、ファイル操作を再試行する必要があります。
COPYENGINE_E_USERCANCELLED
 ユーザーが [キャンセル] をクリックしました。 コピー ジョブ全体が終了しています。 ハンドラーは、このコードをコピー エンジンに返す必要があります。
COPYENGINE_S_USER_IGNORED
 ユーザーが [無視] をクリックしました。 ハンドラーは項目の作成をスキップし、このコードをコピー エンジンに戻す必要があります。

要件

要件 値
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー shobjidl_core.h (Shobjidl.h を含む)