ITransferAdviseSink::P ropertyFailure メソッド (shobjidl_core.h)

  • [アーティクル]

ファイル プロパティに関連するエラーがあり、ユーザー操作が必要な場合に呼び出されます。

構文

HRESULT PropertyFailure(
  [in] IShellItem        *psi,
  [in] const PROPERTYKEY *pkey,
  [in] HRESULT           hrError
);

パラメーター

[in] psi

種類: IShellItem*

エラーの原因となった IShellItem へのポインター。

[in] pkey

型: const PROPERTYKEY*

失われるプロパティに対応する値。 NULL 値は、すべてのプロパティが失われたことを示します。

[in] hrError

種類: HRESULT

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

戻り値

種類: HRESULT

その他の HRESULT を渡す必要があります。 エラーが処理されない場合、戻り値は hrError である必要があります。

リターン コード 説明
COPYENGINE_S_USERRETRY
 ハンドラーはファイル操作を再試行する必要があります。
COPYENGINE_S_USERRETRYWITHNEWNAME
 ハンドラーは 、pszRename バッファーで返される名前を使用して、ファイル操作を再試行する必要があります。
COPYENGINE_S_OVERWRITE
 ユーザーは、ハンドラーが既存のファイルを上書きする必要があることを示しています。
COPYENGINE_S_RETRYWITHOUTSECURITY
 ユーザーは、ハンドラーがセキュリティ記述子なしで操作を再試行する必要があることを示しています。
COPYENGINE_E_USERCANCELLED
 ユーザーが [キャンセル] をクリックしました。 コピー ジョブ全体が終了しています。 ハンドラーは、このコードをコピー エンジンに返す必要があります。

要件

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