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

另请参阅

IMDSPStorage 接口

IMDSPStorage2 接口