IWMDMStorage4::FindStorage 方法 (mswmdm.h)
FindStorage 方法會根據其持續性唯一標識符,擷取目前根記憶體中的記憶體。
語法
HRESULT FindStorage(
[in] WMDM_FIND_SCOPE findScope,
[in] LPCWSTR pwszUniqueID,
[out] IWMDMStorage **ppStorage
);
參數
[in] findScope
WMDM_FIND_SCOPE列舉,指定要搜尋的範圍。
[in] pwszUniqueID
要找到之記憶體的持續性唯一標識符。 記憶體的永續性唯一標識碼是由 記憶體的g_wszWMDMPersistentUniqueID 元數據屬性所描述。
[out] ppStorage
如果找到,則為所擷取記憶體的指標。 呼叫端必須在完成此介面時釋放此介面。
傳回值
方法會傳回 HRESULT。 Windows Media 裝置管理員 中的所有介面方法都可以傳回下列任何一種錯誤碼類別:
- 標準 COM 錯誤碼
- 轉換成 HRESULT 值的 Windows 錯誤碼
- Windows Media 裝置管理員 錯誤碼
備註
此方法只會在裝置上搜尋單一記憶體物件, (快閃卡或硬碟) 。
持續性唯一標識碼可識別儲存在特定裝置上的內容。 它不代表在所有裝置上維持相同內容特定全域唯一標識符。 因此,儲存在不同記憶體中的相同內容會有不同的持續性唯一標識符。 同樣地,儲存在不同的裝置上時,不同的內容可能會有相同的持續性唯一標識符。
持續性唯一標識碼的格式取決於裝置。 應用程式必須先取得先前的持續性唯一標識符,方法是取得記憶體,並查詢其 WMDM/PersistentUniqueID 屬性。 使用 GetSpecifiedMetadata 或 GetMetadata 方法來要求這個屬性。
規格需求
需求 | 值 |
---|---|
目標平台 | Windows |
標頭 | mswmdm.h |
程式庫 | Mssachlp.lib |