ITransferSource::RenameItem メソッド (shobjidl_core.h)

  • [アーティクル]

アイテムの名前を変更し、新しい名前の IShellItem を返します。

構文

HRESULT RenameItem(
  [in]  IShellItem            *psiSource,
  [in]  LPCWSTR               pszNewName,
  [in]  TRANSFER_SOURCE_FLAGS flags,
  [out] IShellItem            **ppsiNewDest
);

パラメーター

[in] psiSource

種類: IShellItem*

名前を変更する IShellItem オブジェクトへのポインター。

[in] pszNewName

種類: LPCWSTR

新しい名前を含む null で終わる Unicode 文字列へのポインター。

[in] flags

種類: TRANSFER_SOURCE_FLAGS

ファイル操作を制御するフラグ。 1 つ以上の TRANSFER_SOURCE_FLAGS 定数。

[out] ppsiNewDest

種類: IShellItem**

このメソッドが戻るとき、 には IShellItem オブジェクトへのポインターのアドレスが含まれます。

戻り値

種類: HRESULT

次のいずれかを返します。エラー コードを返します。

リターン コード 説明
COPYENGINE_S_YES
 ユーザーがダイアログに対して "はい" と応答しました。
COPYENGINE_S_USER_RETRY
 ユーザーが応答して、現在のアクションを再試行しました。
COPYENGINE_S_USER_IGNORED
 ユーザーがダイアログに "いいえ" と応答しました。
COPYENGINE_S_MERGE
 ユーザーがマージ フォルダーに応答しました。
COPYENGINE_S_USER_RETRY_WITH_NEW_NAME
 ユーザーは、新しい名前でファイルを再試行するように応答しました。
COPYENGINE_S_DONT_PROCESS_CHILDREN
 子項目は処理しないでください。
COPYENGINE_S_PENDING
 エラーはキューに登録されており、後で表示されます。
COPYENGINE_E_USER_CANCELLED
 ユーザーが現在のアクションを取り消しました。
COPYENGINE_E_REQUIRES_ELEVATION
 操作には昇格された特権が必要です。

要件

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