IFileOperationProgressSink：:P reCopyItem 方法 (shobjidl_core.h)

在每個項目的複製程序開始之前，先執行呼叫端實作的動作。

語法

HRESULT PreCopyItem(
  [in] DWORD      dwFlags,
  [in] IShellItem *psiItem,
  [in] IShellItem *psiDestinationFolder,
  [in] LPCWSTR    pszNewName
);

[in] dwFlags

類型： DWORD

位值，其中包含控制作業的旗標。如需旗標描述，請參閱TRANSFER_SOURCE_FLAGS 。

[in] psiItem

類型： IShellItem*

指定來源專案的 IShellItem 指標。

[in] psiDestinationFolder

類型： IShellItem*

IShellItem 的指標，指定要包含項目複本的目的地資料夾。

[in] pszNewName

類型： LPCWSTR

複製項目之後，專案的新名稱指標。這是以 Null 結尾的 Unicode 字串，可以是 NULL。如果為 NULL，則目的地專案的名稱與來源相同。

類型： HRESULT

如果成功，則傳回S_OK，否則傳回錯誤值。如果是錯誤值，複製作業和從 IFileOperation 呼叫擱置的所有後續作業都會取消。