IDeviceSpecificProperty::SetValue 方法 (devicetopology.h)
SetValue 方法设置特定于设备的属性的值。
语法
HRESULT SetValue(
[in] void *pvValue,
[in] DWORD cbValue,
[in] LPCGUID pguidEventContext
);
参数
[in] pvValue
指向特定于设备的属性的新值的指针。
[in] cbValue
设备特定属性值的大小(以字节为单位)。
[in] pguidEventContext
IControlChangeNotify::OnNotify 方法的上下文值。 此参数指向事件上下文 GUID。 如果 SetValue 调用更改控件的状态,则已注册 IControlChangeNotify 的所有客户端都会收到该控件的通知。 在 OnNotify 方法的实现中,客户端可以检查事件上下文 GUID,以发现它还是另一个客户端是 control-change 事件的源。 如果调用方为此参数提供 NULL 指针,则客户端的通知方法将收到 NULL 上下文指针。
返回值
如果该方法成功,则它会返回 S_OK。 如果失败,可能的返回代码包括但不限于下表中显示的值。
返回代码 | 说明 |
---|---|
|
指针 pvValue 为 NULL。 |
|
参数 cbValue 与属性值的所需大小不匹配。 |
|
内存不足。 |
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows Vista [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2008 [仅限桌面应用] |
目标平台 | Windows |
标头 | devicetopology.h |