This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

property_set() callback

Called when a client modifies a property value

Synopsis:

#include <sys/pmm.h>

int property_set(void *data, pm_property_attr_t *prop, 
                                           void *val);

Library:

libc

Description:

This function is called when a client modifies a property value:

data

Policy specific data returned by the create() function when the node was created.

prop

Describes the property:

prop->id is the property identifier
prop->size is the size of the property data.

val

Property data set by the client.

The return value from this function is passed back to the client's pm_set_property() call.

The property value is set, even if this call returns an error.

It is expected that the policy always return EOK and this call simply serves to notify the policy of the new value. This is used by the policy to trigger actions that change the system state.

The default action (if the policy does not override this function) is to return EOK to the client.

Returns:

Classification:

QNX Neutrino