IMDSPStorage2::GetStorage 方法 (mswmdm.h)
通过 GetStorage 方法,可以从存储名称直接转到存储对象,而不是枚举所有存储来查找它。
语法
HRESULT GetStorage(
[in] LPCWSTR pszStorageName,
[out] IMDSPStorage **ppStorage
);
参数
[in] pszStorageName
指向包含存储名称的 以 null 结尾的字符串的指针。
[out] ppStorage
指向 pszStorageName 指定的存储对象的指针;如果未找到此类存储,则为 NULL 。
返回值
该方法返回 HRESULT。 Windows Media 设备管理器 中的所有接口方法都可以返回以下任一类错误代码:
- 标准 COM 错误代码
- 转换为 HRESULT 值的 Windows 错误代码
- Windows Media 设备管理器错误代码
注解
IMDSPStorage2::GetStorage 接口扩展了 IMDSPStorage 的功能。
IMDSPStorage2::GetStorage 不支持通配符。 它不是递归的,也就是说,它只会在当前存储中找到存储对象。
如果未实现此方法,则应返回E_NOTIMPL。 (它不应返回WMDM_E_NOT_SUPPORTED或任何其他指示此方法未) 实现的代码。 这将确保 Windows Media 设备管理器会尝试通过枚举所有存储来根据作为 pszStorageName 传入的存储名称查找匹配项来替换此功能本身。
强烈建议服务提供商实现此方法,以便根据名称有效地返回存储对象。
此方法是可选的。 有关详细信息,请参阅 必需接口和可选接口。
要求
要求 | 值 |
---|---|
目标平台 | Windows |
标头 | mswmdm.h |
Library | Mssachlp.lib |