IMDSPDevice3::FindStorage 方法 (mswmdm.h)
FindStorage方法會尋找具有指定永續性唯一識別碼的儲存體。 儲存體的永續性唯一識別碼是由該儲存體的 g_wszWMDMPersistentUniqueID 屬性所描述。
語法
HRESULT FindStorage(
[in] WMDM_FIND_SCOPE findScope,
[in] LPCWSTR pwszUniqueID,
[out] IMDSPStorage **ppStorage
);
參數
[in] findScope
尋找作業的範圍。 它必須是下列其中一個值。
值 | 描述 |
---|---|
WMDM_FIND_SCOPE_GLOBAL | 搜尋整個裝置。 |
WMDM_FIND_SCOPE_IMMEDIATE_CHILDREN | 只在目前儲存體的立即子系中搜尋。 |
[in] pwszUniqueID
儲存體的持續唯一識別碼。
[out] ppStorage
pwszUniqueID參數所指定的傳回儲存體指標。
傳回值
方法會傳回 HRESULT。 Windows Media 裝置管理員中的所有介面方法都可以傳回下列任何一種錯誤碼類別:
- 標準 COM 錯誤碼
- 轉換成 HRESULT 值的 Windows 錯誤碼
- Windows Media 裝置管理員錯誤碼
備註
服務提供者會透過儲存體的 g_wszWMDMPersistentUniqueID 屬性傳回永續性唯一識別碼。 針對特定儲存體,服務提供者所提供的持續性唯一識別碼應該在不同的裝置連線會話之間相同。
應用程式可能會在稍後呼叫具有此持續性唯一識別碼的 FindStorage 。 為了回應,Windows Media 裝置管理員在服務提供者上呼叫此方法, (SP) 。
持續性唯一識別碼可用來唯一識別儲存在特定裝置上的內容。 它不代表在所有裝置上維持相同內容特定全域唯一識別碼。 因此,儲存在不同儲存體中的相同內容會有不同的持續性唯一識別碼。
Windows Media 裝置管理員只會針對已註冊的裝置呼叫此方法,以啟用與Windows 媒體播放機的同步處理。 如需詳細資訊,請參閱使用 Windows 媒體播放機 啟用同步處理。
需求
目標平台 | Windows |
標頭 | mswmdm.h |
程式庫 | Mssachlp.lib |