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