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

  • Artikel

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

Syntax

HRESULT PreRenameItem(
  [in] DWORD      dwFlags,
  [in] IShellItem *psiItem,
  [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-Objekt , das das umzubenennenden Element angibt.

[in] pszNewName

Typ: LPCWSTR

Zeiger auf den neuen Anzeigenamen des Elements. Hierbei handelt es sich um eine Unicode-Zeichenfolge, die null beendet wird.

Rückgabewert

Typ: HRESULT

Gibt bei erfolgreicher Ausführung S_OK oder andernfalls einen Fehlerwert zurück. Im Falle eines Fehlerwerts werden der Umbenennungsvorgang 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 (shobjidl.h einschließen)