IMDSPStorage4：：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 设备管理器中的所有接口方法都可以返回以下任一类错误代码：

有关可能错误代码的广泛列表，请参阅错误代码。

服务提供程序通过存储的 g_wszWMDMPersistentUniqueID 属性返回永久性唯一标识符。对于特定存储，服务提供商提供的持久唯一标识符在不同的设备连接会话中应相同。

应用程序可以在以后调用具有此持久唯一标识符的 FindStorage 。作为响应，Windows Media 设备管理器在服务提供商上调用此方法。

永久性唯一标识符用于唯一标识存储在特定设备上的内容。它不表示在所有设备上保持相同的特定于内容的全局唯一标识符。因此，存储在不同存储中的相同内容将具有不同的永久性唯一标识符。

此方法允许基于永久性唯一标识符搜索存储，而 IMDSPStorage2：：GetStorage 允许基于名称搜索存储。

Windows Media 设备管理器仅对可与Windows 媒体播放器同步的设备调用此方法。有关详细信息，请参阅启用与Windows 媒体播放器的同步。