IWMDMDevice3：：FindStorage 方法 (mswmdm.h)

项目
03/13/2024

FindStorage 方法按其持久唯一标识符查找存储。与其他方法不同，此方法可以从根存储以递归方式进行搜索。

语法

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

参数

[in] findScope

指定查找操作范围的 WMDM_FIND_SCOPE 枚举。

[in] pwszUniqueID

一个以 null 结尾的宽字符字符串，表示存储的永久性唯一标识符，可以通过查询存储的 g_wszWMDMPersistentUniqueID 属性来检索该标识符。

[out] ppStorage

指向返回的存储的指针。调用方在使用完此接口时必须释放它。

返回值

该方法返回 HRESULT。 Windows Media 设备管理器中的所有接口方法都可以返回以下任一类错误代码：

标准 COM 错误代码
转换为 HRESULT 值的 Windows 错误代码
Windows Media 设备管理器错误代码

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

注解

永久性唯一标识符用于唯一标识存储在特定设备上的内容。它不表示在所有设备上保持相同的特定于内容的全局唯一标识符。因此，存储在不同存储中的相同内容将具有不同的永久性唯一标识符。同样，当不同内容存储在不同的设备上时，可以具有相同的持久唯一标识符。使用与数据库中的行类似的设备上的内容的类比，此属性的作用与标识列在数据库中提供相同。

由于它由设备生成，因此永久性唯一标识符的格式依赖于设备。应用程序应通过查询存储的 g_wszWMDMPersistentUniqueID 属性来获取永久性唯一标识符。应用程序可以使用 GetSpecifiedMetadata 或 GetMetadata 方法来查询此属性。