iWMDMStorage4::SetReferences 方法 (mswmdm.h)

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

语法

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

parameters

[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