PEXGetWorkstationAttributes - Get Workstation Attribute Values

Synopsis

 
 PEXWorkstationAttributes *PEXGetWorkstationAttributes(
         Display *display,
         PEXWorkstation workstation,
         unsigned long *value_mask
   )
 

Arguments

display

A pointer to a display structure returned by a successful XOpenDisplay call.

workstation

The resource identifier of the workstation.

value_mask

A mask indicating which workstation attribute values to return.

Returns

A pointer to the workstation attribute values; a null pointer if unsuccessful.

Description

Invoke PEXGetWorkstationAttributes to the attributes of the specified workstation.

This function returns the attributes specified by the value mask. Use the PEXSetPWAttributeMask or PEXSetPWAttributeMaskAll functions to setup the value mask.

PEXlib allocates memory for the returned workstation attribute values. Invoke PEXFreeWorkstationAttributes to deallocate the memory.

Errors

BadPEXWorkstation

The specified workstation resource identifier is invalid.

BadValue

An invalid bit is set in the value mask.

See Also

• PEXGetWorkstationDynamics
• PEXSetPWAttributeMask
• PEXSetPWAttributeMaskAll

For a list of PHIGS Workstation functions and related topics, see PHIGS Workstation.