IWMDMStorage4：：SetReferences 方法 (mswmdm.h)

發行項
03/05/2024

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 媒體裝置管理員錯誤碼

如需可能錯誤碼的廣泛清單，請參閱錯誤碼。

備註

這個方法可用來設定物件中的參考，這些物件是由參考所組成，例如播放清單或相簿。如果裝置不支援元數據，可能不支援此方法。

任何有效的 IWMDMStorage 物件都可以包含在 ppIWMDMStorage 陣列中。這包括資料夾和其他記憶體，指定參考本身 (建立，例如播放清單播放清單) 。裝置本身會決定參考物件的任何特定案例如何處理。 Windows Media 裝置管理員不會強制執行 IWMDMStorage 有效性以外的任何規則。請考慮包含巢狀播放清單參考的播放清單案例。在一部裝置上，不允許這樣做， 而 SetReferences 會 失敗。在另一部裝置上，這是允許的;播放只會以深度優先順序周游整個自主參考集。

當 IWMDMStorage4 介面指針對應到裝置上已不存在的記憶體時，就可能發生這種情況。在此情況下會傳回WMDM_E_INTERFACEDEAD。