ITransferSource::RenameItem-Methode (shobjidl_core.h)
Ändert den Namen eines Elements und gibt das IShellItem mit dem neuen Namen zurück.
Syntax
HRESULT RenameItem(
[in] IShellItem *psiSource,
[in] LPCWSTR pszNewName,
[in] TRANSFER_SOURCE_FLAGS flags,
[out] IShellItem **ppsiNewDest
);
Parameter
[in] psiSource
Typ: IShellItem*
Ein Zeiger auf das IShellItem-Objekt , das umbenannt werden soll.
[in] pszNewName
Typ: LPCWSTR
Ein Zeiger auf eine mit NULL endende Unicode-Zeichenfolge, die den neuen Namen enthält.
[in] flags
Flags, die den Dateivorgang steuern. Mindestens eine der TRANSFER_SOURCE_FLAGS Konstanten.
[out] ppsiNewDest
Typ: IShellItem**
Wenn diese Methode zurückgibt, enthält die Adresse eines Zeigers auf das IShellItem-Objekt .
Rückgabewert
Typ: HRESULT
Gibt einen der folgenden Oder einen Fehlercode zurück.
Rückgabecode | Beschreibung |
---|---|
|
Der Benutzer hat auf das Dialogfeld mit "Ja" geantwortet. |
|
Der Benutzer hat geantwortet, um die aktuelle Aktion erneut auszuführen. |
|
Der Benutzer hat auf das Dialogfeld mit "Nein" geantwortet. |
|
Der Benutzer hat auf Mergeordner geantwortet. |
|
Der Benutzer hat geantwortet, um die Datei mit dem neuen Namen zu wiederholen. |
|
Untergeordnete Elemente sollten nicht verarbeitet werden. |
|
Der Fehler wurde in die Warteschlange eingereiht und wird später angezeigt. |
|
Der Benutzer hat die aktuelle Aktion abgebrochen. |
|
Für den Vorgang sind erhöhte Berechtigungen erforderlich. |
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) |