IMDSPObject::Rename-Methode (mswmdm.h)

Die Rename-Methode benennt das zugeordnete Objekt um, bei dem es sich um eine Datei oder einen Ordner handeln kann.

Syntax

HRESULT Rename(
  [in] LPWSTR        pwszNewName,
  [in] IWMDMProgress *pProgress
);

Parameter

[in] pwszNewName

Zeiger auf eine Zeichenfolge mit breitem NULL-Abschluss, um einen neuen Namen für das Objekt zu erhalten. Informationen zur Verwendung des LPWSTR-Variablentyps finden Sie in der Windows-Dokumentation.

[in] pProgress

Zeiger auf eine von der Anwendung implementierte IWMDMProgress-Schnittstelle , die es der Anwendung ermöglicht, Statusbenachrichtigungen für langwierige Umbenennungsvorgänge zu erhalten.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Alle Schnittstellenmethoden in Windows Media Geräte-Manager können eine der folgenden Klassen von Fehlercodes zurückgeben:

  • Com-Standardfehlercodes
  • In HRESULT-Werte konvertierte Windows-Fehlercodes
  • Windows Media Geräte-Manager Fehlercodes
Eine ausführliche Liste möglicher Fehlercodes finden Sie unter Fehlercodes.

Hinweise

Diese Methode ist optional. Weitere Informationen finden Sie unter Obligatorische und optionale Schnittstellen.

Requirements (Anforderungen)

   
Zielplattform Windows
Kopfzeile mswmdm.h
Bibliothek Mssachlp.lib

Weitere Informationen

IMDSPObject-Schnittstelle

IWMDMProgress-Schnittstelle