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 個元素的參考數位。