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 である必要があります。

要件