.\" @(#)PEXGetWorkstationPostings.3 1.5 95/03/24 SMI;
.so man3/pex.macs
.TH PEXGetWorkstationPostings 3 "May 1995" "Solaris PEXlib Reference Manual" ""
.SH NAME
PEXGetWorkstationPostings - Get Workstation Postings
.SH SYNTAX
.HP
Status PEXGetWorkstationPostings\^(\^Display *\fIdisplay\fP\^, PEXStructure \fIstructure\fP\^, unsigned long *\fIcount_return\fP\^, PEXWorkstation **\fIpostings_return\fP\^)
.SH PARAMETERS
.IP \fIdisplay\fP 1i
A pointer to a display structure returned by a successful
.B XOpenDisplay
call.
.IP \fIstructure\fP 1i
The resource identifier of the structure.
.IP \fIcount_return\fP 1i
Returns the number of workstation identifiers.
.IP \fIpostings_return\fP 1i
Returns an array of workstation resource identifiers.
.SH RETURNS
.LP
Zero if unsuccessful, non-zero otherwise.
.SH DESCRIPTION
.\" indexing
.IX PEXGetWorkstationPostings
.IX "Workstation" "PEXGetWorkstationPostings"
.LP
This function returns a list of workstation resources to which the specified
.I structure
has been posted.
.LP
PEXlib allocates memory for the return value.
.B XFree
should be called to deallocate the memory.
.SH DATA STRUCTURES
.LP
.nf
typedef  XID	PEXStructure;
typedef  XID	PEXWorkstation;
.fi
.SH ERRORS
.TP
.SB BadPEXStructure
The specified structure resource identifier is invalid.
.SH SEE ALSO
.LP
.nf
.BR PEXPostStructure (3)
.BR PEXUnpostStructure (3)
.BR PEXUnpostAllStructures (3)
.fi