Freigeben über

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

  • Artikel

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

Syntax

HRESULT PreMoveItem(
  [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-Element , das das zu verschiebende Element angibt.

[in] psiDestinationFolder

Typ: IShellItem*

Zeiger auf ein IShellItem,das den Zielordner angibt, der das verschobene Element enthalten soll.

[in] pszNewName

Typ: LPCWSTR

Zeiger auf einen neuen Namen für das Element an seiner neuen Position. 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 Fall eines Fehlerwerts werden der Verschiebungsvorgang und alle nachfolgenden Vorgänge, die aus dem Aufruf von IFileOperation ausstehen, abgebrochen.

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)