IWMDMDevice3：：FindStorage 方法 (mswmdm.h)

發行項
02/29/2024

FindStorage 方法會依其永續性唯一標識符尋找記憶體。不同於其他方法，這個方法可以從根記憶體以遞歸方式搜尋。

語法

HRESULT FindStorage(
  [in]  WMDM_FIND_SCOPE findScope,
  [in]  LPCWSTR         pwszUniqueID,
  [out] IWMDMStorage    **ppStorage
);

參數

[in] findScope

指定尋找作業範圍的 WMDM_FIND_SCOPE 列舉。

[in] pwszUniqueID

寬字元、以 Null 結束的字串，代表記憶體的永續性唯一標識元，可藉由查詢記憶體的 g_wszWMDMPersistentUniqueID 屬性來擷取。

[out] ppStorage

傳回記憶體的指標。呼叫端必須在完成時釋放這個介面。

傳回值

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

標準 COM 錯誤碼
轉換成 HRESULT 值的 Windows 錯誤碼
Windows Media 裝置管理員錯誤碼

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

備註

持續性唯一標識碼可用來唯一識別儲存在特定裝置上的內容。它不代表在所有裝置上維持相同內容特定全域唯一標識符。因此，儲存在不同記憶體中的相同內容會有不同的永續性唯一標識符。同樣地，當不同的內容儲存在不同的裝置上時，可能會有相同的永續性唯一標識符。使用裝置上的內容類似資料庫中的數據列，這個屬性的作用與資料庫中的標識列相同。

因為裝置會產生它，所以持續性唯一標識符的格式與裝置相關。應用程式應該藉由查詢記憶體的 g_wszWMDMPersistentUniqueID 屬性來取得永續性唯一標識符。應用程式可以使用 GetSpecifiedMetadata 或 GetMetadata 方法來查詢此屬性。