NAME

UNPOST ALL STRUCTURES − unpost all structures posted to the specified workstation

SYNOPSIS

C Syntax

void
punpost_all_structs ( ws_id )
Pintws_id;workstation identifier

Required PHIGS Operating States

(PHOP, WSOP, ∗, ∗)

DESCRIPTION

Purpose

UNPOST ALL STRUCTURES unposts all of the structures posted to a specified workstation. Following UNPOST ALL STRUCTURES, no structure networks remain eligible for display on the workstation.  The immediate effect of the function on the display surface will depend on the workstation’s display update state. 

C Input Parameter

ws_idAll structures are to be unposted from the workstation with this identifier. 

Execution

UNPOST ALL STRUCTURES removes all the structures from the table of posted structures on the specified workstation. 

The unposted structures are not deleted from the Central Structure Store, and may again be posted to this or another workstation.  No other workstations are affected. 

ERRORS

003Ignoring function, function requires state (PHOP, WSOP, ∗, ∗)

054Ignoring function, the specified workstation is not open

059Ignoring function, the specified workstation does not have output capability (i.e., the workstation category is neither OUTPUT, OUTIN, nor MO)

SEE ALSO

POST STRUCTURE (3P)
INQUIRE POSTED STRUCTURES (3P)
CLOSE WORKSTATION (3P)
UNPOST STRUCTURE (3P)

September 02, 1992