共用方式為


IMDSPStorage4::SetReferences 方法 (mswmdm.h)

SetReferences 方法會設定記憶體中包含的參考,該參考具有 (,例如播放清單/相簿) ,並覆寫此記憶體中任何先前存在的參考。

語法

HRESULT SetReferences(
  [in] DWORD        dwRefs,
  [in] IMDSPStorage **ppISPStorage
);

參數

[in] dwRefs

傳入數位中包含的 IMDSPStorage 介面指標計數。 零是可接受的值,並重設記憶體以包含零參考。 在此情況下,不會刪除記憶體本身。

[in] ppISPStorage

用來設定記憶體中參考的 IMDSPStorage 介面指標數位的指標。 參考的順序符合這個陣列中對應 IWMDMStorage 介面指標的順序。 如果 dwRefs 也是零,NULL 是可接受的值。

傳回值

方法會傳回 HRESULT。 Windows Media 裝置管理員 中的所有介面方法都可以傳回下列任何一種錯誤碼類別:

  • 標準 COM 錯誤碼
  • 轉換成 HRESULT 值的 Windows 錯誤碼
  • Windows 媒體 裝置管理員 錯誤碼
如需可能錯誤碼的廣泛清單,請參閱 錯誤碼

備註

任何有效的 IMDSPStorage 物件都可以包含在 ppIMDSPStorage 陣列中。 這包括資料夾和其他記憶體,其中包含參考本身 (建立,例如播放清單播放清單) 。

根據裝置中的支援層級, (它是否支援播放清單或巢狀播放清單) ,服務提供者應該適當地處理此方法。 如果裝置沒有傳入參考數位所需的支援層級,服務提供者應該傳回WMDM_E_NOTSUPPORTED。

如果參考包含已刪除的記憶體,則應該傳回WMDM_E_INTERFACEDEAD。

SetReferences 方法遵循抹除和載入模型。 傳遞的參考包含完整集合,而且應該完全取代記憶體物件上的任何現有參考。

規格需求

需求
目標平台 Windows
標頭 mswmdm.h
程式庫 Mssachlp.lib

另請參閱

IMDSPStorage4 介面

IMDSPStorage4::GetReferences