通过

iWMDMStorage4：：SetReferences 方法 (mswmdm.h)

  • 项目

SetReferences 方法设置存储中包含的引用，该存储包含引用 (（如播放列表或专辑) ），从而覆盖存储保存的所有以前现有的引用。

语法

HRESULT SetReferences(
  [in] DWORD        dwRefs,
  [in] IWMDMStorage **ppIWMDMStorage
);

参数

[in] dwRefs

ppIWMDMStorage 中的 IWMDMStorage 接口指针计数。 零是可接受的值，它从存储中清除所有引用。 在这种情况下，不会删除存储本身。

[in] ppIWMDMStorage

指向存储要引用的 IWMDMStorage 接口指针数组的指针。 此顺序由存储保留。 如果 dwRefs 也为零，则 NULL 是可接受的值。 调用方负责分配和释放此数组。

返回值

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

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

注解

此方法用于在由引用组成的对象（如播放列表或相册）中设置引用。 如果设备不支持元数据，则此方法可能不受支持。

任何有效的 IWMDMStorage 对象都可以包含在 ppIWMDMStorage 数组中。 这包括指定引用本身的文件夹和其他存储 (创建，例如，) 播放列表。 设备本身确定如何处理引用对象的任何特定情况。 Windows Media 设备管理器不会强制实施 IWMDMStorage 有效性以外的任何规则。 请考虑包含嵌套播放列表引用的播放列表的情况。 在一台设备上，这是不允许的， 并且 SetReferences 会失败。 在另一台设备上，允许这样做;播放只是按深度优先顺序遍历整个包含的引用集。

可能会出现以下情况： IWMDMStorage4 接口指针对应于设备上不再存在的存储。 在本例中返回WMDM_E_INTERFACEDEAD。

要求

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

另请参阅

在设备上创建播放列表

IWMDMStorage4 接口

IWMDMStorage4：：GetReferences