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

Artikel
03/02/2024

Führt vom Aufrufer implementierte Aktionen aus, nachdem der Umbenennungsprozess für jedes Element abgeschlossen ist.

Syntax

HRESULT PostRenameItem(
  [in] DWORD      dwFlags,
  [in] IShellItem *psiItem,
  [in] LPCWSTR    pszNewName,
  [in] HRESULT    hrRename,
  [in] IShellItem *psiNewlyCreated
);

Parameter

[in] dwFlags

Art: DWORD

bitweiser Wert, der Flags enthält, die während des Umbenennungsvorgangs verwendet wurden. Einige Werte können während des Umbenennungsvorgangs festgelegt oder geändert werden. Flagbeschreibungen finden Sie unter TRANSFER_SOURCE_FLAGS .

[in] psiItem

Typ: IShellItem*

Zeiger auf ein IShellItem,das das Element angibt, bevor es umbenannt wurde.

[in] pszNewName

Typ: LPCWSTR

Zeiger auf den neuen Anzeigenamen des Elements. Hierbei handelt es sich um eine Unicode-Zeichenfolge mit Null-Beendigung. Beachten Sie, dass dies aufgrund von Kollisionen und anderen Benennungsregeln möglicherweise nicht der von Ihnen angeforderte Name ist.

[in] hrRename

Typ: HRESULT

Der Rückgabewert des Umbenennungsvorgangs. Beachten Sie, dass dies nicht das von RenameItem zurückgegebene HRESULT ist, das einfach den Umbenennungsvorgang in die Warteschlange stellt. Stattdessen ist dies das Ergebnis des tatsächlichen Umbenennungsvorgangs.

[in] psiNewlyCreated

Typ: IShellItem*

Zeiger auf ein IShellItem , das das Element mit seinem neuen Namen darstellt.

Rückgabewert

Typ: HRESULT

Gibt bei erfolgreicher Ausführung S_OK oder andernfalls einen Fehlerwert zurück. Im Fall eines Fehlerwerts werden alle nachfolgenden Vorgänge abgebrochen, die vom 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)