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