picl_get_root(3PICL) PICL Library Functions picl_get_root(3PICL)
NAME
picl_get_root - get the root handle of the PICL tree
SYNOPSIS
cc [ flag... ] file... -lpicl [ library... ]
#include <picl.h>
int picl_get_root(picl_nodehdl_t *nodehandle);
DESCRIPTION
The picl_get_root() function gets the handle of the root node of the PICL tree and copies it into the location given by nodehandle.
RETURN VALUES
Upon successful completion, 0 is returned. On failure, a non-negative integer is returned to indicate an error.
ERRORS
PICL_NOTINITIALIZED Session not initialized
PICL_NORESPONSE Daemon not responding
PICL_FAILURE General system failure
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
+-----------------------------+-----------------------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+-----------------------------+-----------------------------+
|MT-Level |MT-Safe |
+-----------------------------+-----------------------------+
SEE ALSO
picl_initialize(3PICL), picl_shutdown(3PICL), attributes(5)
SunOS 5.10 28 Mar 2000 picl_get_root(3PICL)
