.\"##
.\" $XConsortium: p401,v 5.2 94/04/17 20:59:07 rws Exp $
.\"##
.\"## 
$XMCOPY
.\"## Copyright (c) 1990, 1991 by Sun Microsystems, Inc. 
.\"## 
.\"##                         All Rights Reserved
.\"## 
.\"## Permission to use, copy, modify, and distribute this software and its 
.\"## documentation for any purpose and without fee is hereby granted, 
.\"## provided that the above copyright notice appear in all copies and that
.\"## both that copyright notice and this permission notice appear in 
.\"## supporting documentation, and that the name of Sun Microsystems,
.\"## not be used in advertising or publicity 
.\"## pertaining to distribution of the software without specific, written 
.\"## prior permission.  
.\"## 
.\"## SUN MICROSYSTEMS DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, 
.\"## INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
.\"## EVENT SHALL SUN MICROSYSTEMS BE LIABLE FOR ANY SPECIAL, INDIRECT OR
.\"## CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF
.\"## USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
.\"## OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
.\"## PERFORMANCE OF THIS SOFTWARE.
.TH "UNPOST STRUCTURE" 3P "29 February 1991"
.SH NAME
UNPOST STRUCTURE \- unpost a structure from the
specified workstation
.SH SYNOPSIS
.SS C Syntax
.ft B
.ta 1.25i 3i
.nf
void
punpost_struct ( ws_id, struct_id )
Pint	ws_id;	\fIworkstation identifier\fP
Pint	struct_id;	\fIstructure identifier\fP
.fi
.ft R
.SS Required PHIGS Operating States
(PHOP, WSOP, *, *)
.SH DESCRIPTION
.SS Purpose
\s-2UNPOST STRUCTURE\s+2 unposts a single structure from a
workstation.
The structure is not deleted from the Central Structure Store (\s-2CSS\s+2),
but it is no longer eligible for display on the workstation.
.LP
The immediate effect of the function on the display surface will
depend on the workstation's display update state.
.SS C Input Parameters
.IP \fIws_id\fP
The structure is to be unposted from the workstation with this identifier.
.IP \fIstruct_id\fP
The identifier of the structure to be unposted.
.SS Execution
\s-2UNPOST STRUCTURE\s+2 removes the structure specified
from the table of posted structures on the workstation.
Unless the structure is part of a structure network posted to the workstation,
the structure is no longer eligible for display on the workstation,
and changes to the structure will no longer affect the workstation.
.LP
The structure is not deleted from the \s-2CSS\s+2 and may again
be posted to the same or another workstation.
Other workstations are unaffected.
.LP
If structure identifier is not listed in the table of posted structures or
does not exist in the \s-2CSS\s+2 when \s-2UNPOST
STRUCTURE\s+2 is called, the function takes no action.
.LP
The effect of unposting the structure may be immediately visible on the
workstation's display, depending on the
workstation's display update state.
.SH ERRORS
.IP 003
Ignoring function, function requires state (\s-2PHOP, WSOP, *, *\s+2)
.IP 054
Ignoring function, the specified workstation is not open
.IP 059
Ignoring function, the specified workstation does not have output capability
(i.e., the workstation category is neither \s-2OUTPUT\s+2, \s-2OUTIN\s+2, nor \s-2MO\s+2)
.SH SEE ALSO
.nf
.IP
.ta 0.5i
.SM "POST STRUCTURE (3P)"
.SM "INQUIRE POSTED STRUCTURES (3P)"
.SM "INQUIRE SET OF WORKSTATIONS TO WHICH POSTED (3P)"
.SM "UNPOST ALL STRUCTURES (3P)"
.fi
