IMDSPStorage4：：GetReferences 方法 (mswmdm.h)

GetReferences 方法返回指向 IMDSPStorage 对象的指针数组，这些对象包含关联存储中包含的引用，例如表示播放列表或专辑对象的引用。

语法

HRESULT GetReferences(
  [out] DWORD        *pdwRefs,
  [out] IMDSPStorage ***pppISPStorage
);

[out] pdwRefs

指向 pppIWMDMStorage 中返回的 IWMDMStorage 接口指针计数的指针的指针。

[out] pppISPStorage

指向表示对存储引用的 IWMDMStorage 接口指针数组的指针的指针的指针。例如，此类引用可以表示播放列表或专辑中的项目。引用的顺序与此数组中的排序匹配。此数组的内存应由服务提供程序分配。

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

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

Windows Media 设备管理器使用此方法获取关联存储（如播放列表或专辑）上的引用。

如果存储具有对已从设备中删除的一个或多个项的引用，则 SP 不应在返回的引用中包含这些引用。 SP 应通过返回S_FALSE来指示此类条件。应用程序可以选择使用此处返回的已知良好引用来刷新关联存储对象。 SP 还可以刷新引用本身。

如果引用计数为 0，则服务提供程序必须返回包含 0 个元素的引用数组。