IFileOperation::MoveItem メソッド (shobjidl_core.h)

指定した宛先に移動する 1 つの項目を宣言します。

構文

HRESULT MoveItem(
  [in] IShellItem                 *psiItem,
  [in] IShellItem                 *psiDestinationFolder,
  [in] LPCWSTR                    pszNewName,
  [in] IFileOperationProgressSink *pfopsItem
);

パラメーター

[in] psiItem

種類: IShellItem*

ソース項目を指定する IShellItem へのポインター。

[in] psiDestinationFolder

種類: IShellItem*

移動されたアイテムを格納する移動先フォルダーを指定する IShellItem へのポインター。

[in] pszNewName

種類: LPCWSTR

新しい場所にある項目の新しい名前へのポインター。 これは null で終わる Unicode 文字列であり、 NULL にすることができます。 NULL の場合、コピー先アイテムの名前はソースと同じです。

[in] pfopsItem

種類: IFileOperationProgressSink*

この特定の移動操作の進行状況とエラー通知に使用される IFileOperationProgressSink オブジェクトへのポインター。 操作全体に対して IFileOperation::Advise を呼び出すと、移動操作の進行状況とエラー通知がそこに含まれるため、このパラメーターを NULL に設定します。

戻り値

型: HRESULT

このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。

注釈

このメソッドはアイテムを移動せず、移動する項目を宣言するだけです。 オブジェクトを移動するには、少なくともここで詳しく説明されている一連の呼び出しを行う必要があります。

1. IFileOperation::MoveItem を呼び出して、ソースアイテム、宛先フォルダー、および宛先名を宣言します。
2. IFileOperation::P erformOperations を呼び出して、移動操作を開始します。

要件

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

こちらもご覧ください

IFileOperation

IFileOperation::MoveItems

PostMoveItem

PreMoveItem