将命名属性设置为给定值。
语法
HRESULT SetValueByName(
[in] PCWSTR name,
[in] const BYTE *data,
UINT32 dataSize
);
参数
[in] name
类型： PCWSTR
要设置的属性的名称。
[in] data
类型： const BYTE*
要设置的数据。
dataSize
类型： UINT32
要设置的数据中的字节数。
返回值
类型： HRESULT
该方法返回 HRESULT。 可能的值包括（但并不限于）下表中的项。
| HRESULT | 说明 |
|---|---|
| S_OK | 未发生错误。 |
| D2DERR_INVALID_PROPERTY | 指定的属性不存在。 |
| E_OUTOFMEMORY | 未能分配必要的内存。 |
| D3DERR_OUT_OF_VIDEO_MEMORY | 未能分配所需的视频内存。 |
| E_INVALIDARG | 一个或多个参数无效。 |
| E_FAIL | 未知故障。 |
备注
如果该属性不存在，则忽略请求，并且该方法返回 D2DERR_INVALID_PROPERTY。
属性实现返回的标准集中未出现的任何错误都将映射到标准错误范围。
要求
| 最低受支持的客户端 | 适用于 Windows 7 的 Windows 8 和平台更新 [桌面应用 |UWP 应用] |
| 最低受支持的服务器 | Windows Server 2012 和适用于 Windows Server 2008 R2 的平台更新 [桌面应用 |UWP 应用] |
| 目标平台 | Windows |
| 标头 | d2d1_1.h |
| Library | D2d1.lib |
| DLL | D2d1.dll |