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 を含む)