IMDSPStorage4：：FindStorage 方法 (mswmdm.h)

FindStorage 方法會尋找具有指定永續性唯一標識符的記憶體。記憶體的永續性唯一標識碼是由該記憶體 的 g_wszWMDMPersistentUniqueID 屬性所描述。

語法

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

[in] findScope

尋找作業的範圍。它必須是下列其中一個值。

值	Description
WMDM_FIND_SCOPE_GLOBAL	搜尋整個裝置。
WMDM_FIND_SCOPE_IMMEDIATE_CHILDREN	只在目前記憶體的直接子系中搜尋。

[in] pwszUniqueID

記憶體的持續唯一標識符。

[out] ppStorage

pwszUniqueID 參數所指定之傳回記憶體的指標。

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

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

服務提供者會透過記憶體 的 g_wszWMDMPersistentUniqueID 屬性傳回永續性唯一標識符。針對特定記憶體，服務提供者所提供的永續性唯一標識符應該在不同的裝置聯機會話之間相同。

應用程式可能會在稍後呼叫具有此持續性唯一標識符的 FindStorage 。為了回應，Windows Media 裝置管理員在服務提供者上呼叫此方法。

持續性唯一標識碼可用來唯一識別儲存在特定裝置上的內容。它不代表在所有裝置上維持相同內容特定全域唯一標識符。因此，儲存在不同記憶體中的相同內容會有不同的永續性唯一標識符。

這個方法允許根據永續性唯一標識符搜尋記憶體，而 IMDSPStorage2：：GetStorage 允許根據名稱搜尋記憶體。

Windows Media 裝置管理員只會針對可與 Windows 媒體播放器同步處理的裝置呼叫這個方法。如需詳細資訊，請參閱啟用與 Windows 媒體播放器同步處理。