imDSPStorage4::SetReferences 方法 (mswmdm.h)

SetReferences 方法设置存储中包含的引用,该存储包含引用 (如播放列表/专辑) ,覆盖此存储中包含的以前存在的任何引用。

语法

HRESULT SetReferences(
  [in] DWORD        dwRefs,
  [in] IMDSPStorage **ppISPStorage
);

参数

[in] dwRefs

传入数组中包含的 IMDSPStorage 接口指针的计数。 零是可接受的值,将存储重置为包含零个引用。 在这种情况下,不会删除存储本身。

[in] ppISPStorage

指向 IMDSPStorage 接口指针数组的指针,这些指针用于设置存储中的引用。 引用的排序与此数组中相应 IWMDMStorage 接口指针的顺序匹配。 如果 dwRefs 也为零,则 NULL 是可接受的值。

返回值

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

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

注解

任何有效的 IMDSPStorage 对象都可以包含在 ppIMDSPStorage 数组中。 这包括文件夹和包含引用本身 (创建的其他存储,例如,) 播放列表。

根据设备中的支持级别 (它是否支持播放列表或嵌套播放列表) ,服务提供商应适当处理此方法。 如果设备没有传入的引用数组所需的支持级别,则服务提供程序应返回WMDM_E_NOTSUPPORTED。

如果引用包含已删除的存储,应返回WMDM_E_INTERFACEDEAD。

SetReferences 方法遵循擦除和加载模型。 传递的引用包括一个完整的集,应完全替换存储对象上的任何现有引用。

要求

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

另请参阅

IMDSPStorage4 接口

IMDSPStorage4::GetReferences