.\" @(#)PEXGetNameSet.3 1.5 95/03/24 SMI;
.so man3/pex.macs
.TH PEXGetNameSet 3 "May 1995" "Solaris PEXlib Reference Manual" ""
.SH NAME
PEXGetNameSet - Get Name Set
.SH SYNTAX
.HP
Status PEXGetNameSet\^(\^Display *\fIdisplay\fP\^, PEXNameSet \fInameset\fP\^, unsigned long *\fIcount_return\fP\^, PEXName **\fInames_return\fP\^)
.SH PARAMETERS
.IP \fIdisplay\fP 1i
A pointer to a display structure returned by a successful
.B XOpenDisplay
call.
.IP \fInameset\fP 1i
The resource identifier of the name set to be queried.
.IP \fIcount_return\fP 1i
Returns the number of names.
.IP \fInames_return\fP 1i
Returns an array of names.
.SH RETURNS
.LP
Zero if unsuccessful; non-zero otherwise.
.SH DESCRIPTION
.\" indexing
.IX PEXGetNameSet
.IX "Name Set" PEXGetNameSet
.LP
This function returns the names in the specified name set.
.LP
PEXlib allocates memory for the return value.
.B XFree
should be called to deallocate the memory.
.SH DATA STRUCTURES
.LP
.nf
typedef  XID			PEXNameSet;
typedef  unsigned long		PEXName;
.fi
.SH ERRORS
.TP
.SB BadPEXNameSet
The specified name set resource identifier is invalid.
.SH SEE ALSO
.LP
.nf
.BR PEXCreateNameSet (3)
.BR PEXChangeNameSet (3)
.fi