IWMDMDevice3::SetProperty 方法 (mswmdm.h)

SetProperty 方法设置特定的设备属性(如果它是可写的)。

语法

HRESULT SetProperty(
  [in] LPCWSTR           pwszPropName,
  [in] const PROPVARIANT *pValue
);

参数

[in] pwszPropName

要设置的属性的宽字符、以 null 结尾的字符串名称。 这会覆盖任何具有相同名称的现有属性。 应用程序进行此调用后,它应使用 PropVariantClear 释放任何动态内存。 元数据常量中提供了标准属性名称 常量的列表。

[in] pValue

正在设置的属性的值。

返回值

该方法返回 HRESULT。 Windows Media 设备管理器 中的所有接口方法都可以返回以下任一类错误代码:

  • 标准 COM 错误代码
  • 转换为 HRESULT 值的 Windows 错误代码
  • Windows Media 设备管理器错误代码
有关可能错误代码的广泛列表,请参阅 错误代码

注解

此方法设置指定的设备属性。 若要获取受支持的设备属性列表,客户端应查询 IWMDMDevice3::GetProperty 方法 以获取g_wszWMDMSupportedDeviceProperties 属性。

有关设备属性名称的列表,请参阅 元数据常量

此方法类似于用于存储的 SetMetadata 方法,但此方法一次只能设置一个属性。

并非所有设备属性都可以设置。

要求

要求
目标平台 Windows
标头 mswmdm.h
Library Mssachlp.lib

另请参阅

枚举设备

IWMDMDevice3 接口

IWMDMDevice3::GetProperty

IWMDMStorage3::SetMetadata

IWMDMStorage4::GetSpecifiedMetadata

设置文件中的元数据