共用方式為


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 屬性。 使用 GetSpecifiedMetadataGetMetadata 方法來要求這個屬性。

規格需求

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

另請參閱

IWMDMDevice3::FindStorage

IWMDMStorage3::GetMetadata

IWMDMStorage4 介面

IWMDMStorage4::GetSpecifiedMetadata

WMDM_FIND_SCOPE