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
Library Mssachlp.lib

另请参阅

IWMDMDevice3::FindStorage

IWMDMStorage3::GetMetadata

IWMDMStorage4 接口

IWMDMStorage4::GetSpecifiedMetadata

WMDM_FIND_SCOPE