Edit

IDeviceSpecificProperty::SetValue method (devicetopology.h)

  • Article

The SetValue method sets the value of the device-specific property.

Syntax

HRESULT SetValue(
  [in] void    *pvValue,
  [in] DWORD   cbValue,
  [in] LPCGUID pguidEventContext
);

Parameters

[in] pvValue

Pointer to the new value for the device-specific property.

[in] cbValue

The size in bytes of the device-specific property value.

[in] pguidEventContext

Context value for the IControlChangeNotify::OnNotify method. This parameter points to an event-context GUID. If the SetValue call changes the state of the control, all clients that have registered IControlChangeNotify interfaces with that control receive notifications. In its implementation of the OnNotify method, a client can inspect the event-context GUID to discover whether it or another client is the source of the control-change event. If the caller supplies a NULL pointer for this parameter, the client's notification method receives a NULL context pointer.

Return value

If the method succeeds, it returns S_OK. If it fails, possible return codes include, but are not limited to, the values shown in the following table.

Return code Description
E_POINTER
 Pointer pvValue is NULL.
E_INVALIDARG
 Parameter cbValue does not match the required size of the property value.
E_OUTOFMEMORY
 Out of memory.

Requirements

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Target Platform Windows
Header devicetopology.h

See also

IDeviceSpecificProperty Interface