Upon successful completion, 0 is returned.
On failure, a non-negative integer is returned to indicate an error.
PICL_ENDOFLIST is returned to indicate that
there are no more properties.
PICL_STALEHANDLE is returned if the handle
is no longer valid. This occurs if the PICL tree was refreshed or reinitialized.
PICL_INVALIDHANDLE is returned if the specified
handle never existed. This error may be returned for a previously valid
handle if the daemon was brought down and restarted. When this occurs a
client must revalidate any saved handles.
|