iWMDMStorageControl：:D elete 方法 (mswmdm.h)

项目
02/29/2024

Delete 方法永久删除此存储。

语法

HRESULT Delete(
  [in] UINT          fuMode,
  [in] IWMDMProgress *pProgress
);

参数

[in] fuMode

以下一个或两个标志，结合按位 OR。指定前两种模式中的一种;第三种模式是可选的。

“模式”	说明
WMDM_MODE_BLOCK	该操作使用块模式 (同步) 处理来执行。在操作完成之前，调用不会返回。
WMDM_MODE_THREAD	该操作使用线程模式 (异步) 处理来执行。调用将立即返回，操作在后台线程中执行。
WMDM_MODE_RECURSIVE	如果存储对象是文件夹，则删除该文件夹及其内容以及所有子文件夹及其内容。

[in] pProgress

指向 Windows Media 设备管理器用于向应用程序报告进度的 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 设备管理器将向此对象发送进度通知。此对象只有在收到结束通知后才能销毁。如果不这样做，将导致访问冲突。