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

另请参阅

IMDSPDevice2 接口