IWMDMStorageControl：：Rename 方法 (mswmdm.h)

项目
03/05/2024

Rename 方法重命名当前存储。

语法

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

参数

[in] fuMode

用于 重命名 操作的处理模式。指定以下两种模式之一。如果同时指定了两种模式，则使用块模式。

“模式”	说明
WMDM_MODE_BLOCK	该操作是使用块模式处理执行的。在操作完成之前，调用不会返回。
WMDM_MODE_THREAD	该操作是使用线程模式处理执行的。调用将立即返回，并且操作在后台线程中执行。

[in] pwszNewName

指向以 null 结尾的宽字符字符串的指针，该字符串指定新名称。

[in] pProgress

指向已由应用程序实现的 IWMDMProgress 接口的可选指针，用于跟踪操作的进度。

返回值

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

标准 COM 错误代码
转换为 HRESULT 值的 Windows 错误代码
Windows Media 设备管理器错误代码

有关可能错误代码的广泛列表，请参阅错误代码。

注解

如果指定了WMDM_MODE_THREAD标志，则应通过调用 IWMDMProgress2：：End2 或 IWMDMProgress3：：End3 来获取完成状态。这些方法将确保操作完成，并且还会返回包含成功或失败信息的 HRESULT。

如果应用程序使用 WMDM_MODE_THREAD 并传递非 null pProgress 参数，则应用程序必须确保在读取操作完成之前不会销毁 pProgress 所属的对象，因为 Windows Media 设备管理器将向此对象发送进度通知。此对象只有在收到结束通知后才能销毁。如果不这样做，将导致访问冲突。