NAME

ptree_init_propinfo - initialize ptree_propinfo_t structure

SYNOPSIS

cc [ flag... ] file... -lpicltree [ library... ]
#include <picltree.h>
int ptree_init_propinfo(ptree_propinfo_t *infop, int version,


     int ptype, int pmode, size_t psize, char *pname,


     int (*readfn)(ptree_rarg_t *, void *),


     int (*writefn)(ptree_warg_t *, const void *));

DESCRIPTION

The ptree_init_propinfo() function initializes a ptree_propinfo_t property information structure given by location infop with the values provided by the arguments.

The version argument specifies the version of the ptree_propinfo_t structure. PTREE_PROPINFO_VERSION gives the current version. The arguments ptype, pmode, psize, and pname specify the property's PICL type, access mode, size, and name. The maximum size of a property name is defined by PICL_PROPNAMELEN_MAX. The arguments readfn and writefn specify a volatile property's read and write access functions. For non-volatile properties, these are set to NULL.

RETURN VALUES

Upon successful completion, 0 is returned. On failure, a non-negative integer is returned to indicate an error.

ERRORS

PICL_INVALIDARG

Invalid argument

PICL_NOTSUPPORTED

Property version not supported

PICL_FAILURE

General system failure

ATTRIBUTES

See attributes(7) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Interface Stability	Evolving
MT-Level	MT-Safe