[ Previous | Next | Contents | Glossary | Home | Search ]
The graPHIGS Programming Interface : Subroutine Reference

GPDLST - Delete Structure

GPDLST (strid)

Purpose

Use GPDLST to delete the specified structure, its identifier, and its contents. This subroutine removes all references to the deleted structure (execute structure-type elements) from all existing structures. The deleted structure is also disassociated from all workstations.

If it is necessary to empty the contents of a specified structure and at the same time maintain its association with all workstations, use the Empty Structure (GPEST) subroutine References to this now emptied structure remain intact.

Parameters

strid -- specified by user, fullword integer

Structure identifier.

Error Codes

12
FUNCTION REQUIRES STATE SSSL

Related Subroutines

GPCEXS
Conditional Execute Structure
GPDRW
Disassociate Root from Workstation
GPEST
Empty Structure
GPEXST
Execute Structure

RCP code

201332737 (X'0C001801')


[ Previous | Next | Contents | Glossary | Home | Search ]