.\" @(#)PEXGetDefinedIndices.3 1.5 95/03/24 SMI;
.so man3/pex.macs
.TH PEXGetDefinedIndices 3 "May 1995" "Solaris PEXlib Reference Manual" ""
.SH NAME
PEXGetDefinedIndices - Get Lookup Table Defined Indices
.SH SYNTAX
.HP
Status PEXGetDefinedIndices\^(\^Display *\fIdisplay\fP\^, PEXLookupTable \fItable\fP\^, unsigned long *\fIcount_return\fP\^, PEXTableIndex **\fIindices_return\fP\^)
.SH PARAMETERS
.IP \fIdisplay\fP 1i
A pointer to a display structure returned by a successful
.B XOpenDisplay
call.
.IP \fItable\fP 1i
The resource identifier of the lookup table.
.IP \fIcount_return\fP 1i
Returns the number of returned indices.
.IP \fIindices_return\fP 1i
Returns an array of indices to defined table entries.
.SH RETURNS
Zero if unsuccessful, non-zero otherwise.
.SH DESCRIPTION
.\" indexing
.IX PEXGetDefinedIndices
.IX "Lookup Table" PEXGetDefinedIndices
.LP
This function returns the defined indices for the specified lookup table.
The index
of each defined table entry is returned in a list.
.LP
PEXlib allocates memory for the returned indices.
.B XFree
should be called to deallocate the memory.
.SH DATA STRUCTURES
.LP
.nf
typedef  XID			PEXLookupTable;
typedef  unsigned short		PEXTableIndex;
.fi
.SH ERRORS
.TP
.SB BadPEXLookupTable
The specified lookup table resource identifier is invalid, or the table type is
unsupported.
.SH SEE ALSO
.LP
.nf
.BR PEXCreateLookupTable (3)
.BR PEXGetTableInfo (3)
.fi