IFileOperation：：MoveItem 方法 (shobjidl_core.h)

宣告要移至指定目的地的單一專案。

語法

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：：建議 ，則會在該處包含移動作業的進度狀態和錯誤通知，因此請將此參數設定為 NULL。

傳回值

類型： HRESULT

如果此方法成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

備註

這個方法不會移動專案，只會宣告要移動的專案。 若要移動物件，您必須至少進行此處詳述的呼叫順序：

1. 呼叫 IFileOperation：：MoveItem 以宣告來源專案、目的地資料夾和目的地名稱。
2. 呼叫 IFileOperation：:P erformOperations 開始移動作業。

規格需求

另請參閱

IFileOperation

IFileOperation：：MoveItems

PostMoveItem

PreMoveItem