IFileOperationProgressSink::P reCopyItem-Methode (shobjidl_core.h)

Führt vom Aufrufer implementierte Aktionen aus, bevor der Kopiervorgang für jedes Element beginnt.

Syntax

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

Parameter

[in] dwFlags

Art: DWORD

bitweiser Wert, der Flags enthält, die den Vorgang steuern. Flagbeschreibungen finden Sie unter TRANSFER_SOURCE_FLAGS .

[in] psiItem

Typ: IShellItem*

Zeiger auf ein IShellItem,das das Quellelement angibt.

[in] psiDestinationFolder

Typ: IShellItem*

Zeiger auf ein IShellItem,das den Zielordner angibt, der die Kopie des Elements enthalten soll.

[in] pszNewName

Typ: LPCWSTR

Zeiger auf einen neuen Namen für das Element, nachdem es kopiert wurde. Dies ist eine mit NULL beendete Unicode-Zeichenfolge und kann NULL sein. Bei NULL ist der Name des Zielelements identisch mit der Quelle.

Rückgabewert

Typ: HRESULT

Gibt bei erfolgreicher Ausführung S_OK oder andernfalls einen Fehlerwert zurück. Im Falle eines Fehlerwerts werden der Kopiervorgang und alle nachfolgenden Vorgänge abgebrochen, die ab dem Aufruf von IFileOperation ausstehen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shobjidl_core.h (einschließlich Shobjidl.h)