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

ボリュームまたは名前空間内の項目を移動し、新しい場所に IShellItem を返します。

構文

HRESULT MoveItem(
  [in]  IShellItem            *psi,
  [in]  IShellItem            *psiParentDst,
  [in]  LPCWSTR               pszNameDst,
        TRANSFER_SOURCE_FLAGS flags,
  [out] IShellItem            **ppsiNew
);

パラメーター

[in] psi

種類: IShellItem*

移動する IShellItem へのポインター。

[in] psiParentDst

種類: IShellItem*

宛先の新しい親項目を表す IShellItem へのポインター。

[in] pszNameDst

種類: LPCWSTR

宛先パスを含む null で終わるバッファーへのポインター。

flags

種類: TRANSFER_SOURCE_FLAGS

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

[out] ppsiNew

種類: IShellItem**

このメソッドが正常に返されると、新しい場所に IShellItem へのポインターのアドレスが含まれます。

戻り値

種類: HRESULT

移動が成功した場合 S_OK を返します。 その場合、 ppsiNew は新しい項目のアドレスを指します。 成功コードと失敗コードの両方で返されるその他の戻り値には、次のようなものがあります。

リターン コード	説明
COPYENGINE_S_USER_IGNORED	宛先アイテムは既に存在し、上書きされていません。 この場合、 ppsiNew は NULL であり、呼び出し元はソースアイテムを削除する必要があります。
COPYENGINE_S_MERGE	宛先アイテムは既に存在し、ユーザーはソース フォルダーとコピー先フォルダーのマージを選択しました。 この場合、 ppsiNew は NULL 値を指し、呼び出し元はソース アイテムを削除する必要があります。
E_NOINTERFACE	移動するアイテムがフォルダーの場合、呼び出し元は移動操作をコピーおよび削除操作に変換する必要があります。
ERROR_NOT_SAME_DEVICE	呼び出し元は、移動操作をコピーおよび削除操作に変換する必要があります。 このエラーは と見な HRESULT_FROM_WIN32(ERROR_NOT_SAME_DEVICE)されます。
ERROR_FILE_EXISTS	フォルダーを移動する場合、呼び出し元は移動操作をコピーおよび削除操作に変換する必要があります。 宛先アイテムは ITransferDestination をサポートしている必要があります。 このエラーは と見な HRESULT_FROM_WIN32(ERROR_FILE_EXISTS)されます。
ERROR_ALREADY_EXISTS	フォルダーを移動する場合、呼び出し元は移動操作をコピーおよび削除操作に変換する必要があります。 宛先アイテムは ITransferDestination をサポートしている必要があります。 このエラーは と見な HRESULT_FROM_WIN32(ERROR_ALREADY_EXISTS)されます。

要件

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