Description

An scf_property_t is an opaque handle that can be set to a
single property at any given time. When set, it inherits the point-in-time
from the source scf_propertygroup_t and does not change until reset.

The scf_property_create() function allocates and initializes a new scf_property_t bound to handle.
The scf_property_destroy() function destroys and frees prop.

The scf_property_handle() function returns the handle to which prop is bound.

The scf_property_type() function retrieves the type of the property to which prop
is set.

The scf_property_is_type() function determines if the property is compatible with type. See
scf_value_create(3SCF).

The scf_property_get_value() function retrieves the single value that the property to which
prop is set contains. If the property has more than one value,
the value argument is set to one of the values. To retrieve
all values associated with a property, see scf_iter_property_values(3SCF).

The scf_pg_get_property() function sets prop to the property specified by name in
the property group specified by pg.

Return Values

Upon successful completion, scf_property_create() returns a new scf_property_t. Otherwise, it returns NULL.

Upon successful completion, scf_property_get_name() function returns the length of the string
written, not including the terminating null byte. Otherwise, it returns -1.