IMDSPObject::Rename 方法 (mswmdm.h)

Rename 方法重命名关联的对象,该对象可以是文件或文件夹。

语法

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

parameters

[in] pwszNewName

指向宽字符 null 结尾字符串的指针,用于接收对象的新名称。 有关如何使用 LPWSTR 变量类型的信息,请参阅 Windows 文档。

[in] pProgress

指向应用程序实现的 IWMDMProgress 接口的指针,使应用程序能够接收冗长重命名操作的进度通知。

返回值

该方法返回 HRESULT。 Windows Media 设备管理器 中的所有接口方法都可以返回以下任一类错误代码:

  • 标准 COM 错误代码
  • 转换为 HRESULT 值的 Windows 错误代码
  • Windows Media 设备管理器错误代码
有关可能错误代码的广泛列表,请参阅 错误代码

注解

此方法是可选的。 有关详细信息,请参阅 必需接口和可选接口

要求

   
目标平台 Windows
标头 mswmdm.h
Library Mssachlp.lib

请参阅

IMDSPObject 接口

IWMDMProgress 接口