HP-UX Reference (11i v3 07/02) - 3 Library Functions A-M (vol 6)

l
libIO(3X) libIO(3X)
key String corresponding to query field.
ptr Pointer to copy of queried data.
Return Value
Number of bytes copied - Upon success.
IO_ERROR - Otherwise. io_errno is set to indicate the error.
Errors
[IO_E_DCONF_ACCESS]
[IO_E_DCONF_OPEN]
[IO_E_KEY_TOKEN_DEF]
[IO_E_PARM]
[IO_E_SYSCALL]
libIO FUNCTION
Name
io_query_batch()
- creates multiple keys to call io_query_array()
Synopsis
int io_query_batch(io_token_t token, int type, char *key1,
void *dat1,char *key2, void *dat2, ...,
char *keyN,void *datN,NULL);
Description
This routine copies the key/dat arguments (one or more pair) into an array and calls
io_query_array() with the passed search parameters.
Arguments
token Token returned by previous call to
io_search() .
type Specifies type (see io_query() ).
key Query field string.
dat Query field data.
Return Value
See Return Value section of io_query_array()
.
Errors
See the Errors section of
io_query_array()
.
libIO FUNCTION
Name
io_query_array()
- gets information (multiple fields) about a token
Synopsis
int io_query_array(io_token_t token, int type,
int nkeys, char *key[], void *ptr[]);
Description
This routine is an enhancement to io_query() . It returns multiple fields for a token at one time.
Arguments
token Token returned by previous call to io_search() .
type Type of query (see io_query() ).
nkeys Number of keys in the query.
key[ ] An array of query field string.
ptr[ ] An array of corresponding query field data.
HP-UX 11i Version 3: February 2007 − 9 − Hewlett-Packard Company 727