HP-UX

NAME

isetdata − Store a pointer to a data structure and associate it with a session
 
igetdata − Return pointer to data structure previously stored by isetdata

SYNOPSIS

 #include <sicl.h>
 int isetdata (INST id, void *data);
 
 int igetdata (INST id, void **data);

DESCRIPTION

The isetdata command is used to store a pointer to a structure.  The data parameter can be any abitrary data for use in an application.  This pointer is stored in the session and may be retrieved at any time later, including inside a handler, using igetdata. 
 
The igetdata will return in data the same value stored by isetdata.  If no previous call was made to isetdata, then a ((void *)0) will be stored into data. 
 

RETURN VALUE

isetdata,igetdata return (0) if successful, or a non-zero error code if an error was encountered. 

ERRORS

isetdata and igetdata fail under the following circumstances, and returns one of the following values:
 

­[I_ERR_NORSRC] Out of system resources

­[I_ERR_NOINTF] Interface is not active

­[I_ERR_NODEV] Device is not active

­[I_ERR_BADID] The INST id is invalid

SEE ALSO

igeterrno(3), igeterrstr(3)
 

AUTHOR

isetdata was developed by HP. 

Hewlett-Packard Company  —  September 29, 1999