UnRegisterCtree

Unregister a c-tree Plus instance.

Short Name

UNRCTREE()

Type

Low-level function

Declaration

COUNT UnRegisterCtree(pTEXT regid)

Description

UnRegisterCtree() frees the allocated memory for the c-tree Plus global structure belonging to the registration reference name pointed to by regid.

Return

Value	Symbolic Constant	Explanation
0	NO_ERROR	Instance successfully unregistered.
516	GNUL_ERR	ctNOGLOBALS not defined.
517	GNOT_ERR	regid is not registered.

See c-tree Plus Error Codes for a complete listing of valid c-tree Plus error values.

Example

TEXT     inpbuf[32];   /* input buffer */


ctrt_printf("\nEnter Instance Name\n");

gets(inpbuf);

if (RegisterCtree(inpbuf))

    ctrt_printf("\nCould not unregister {%s} data base", inpbuf);

    ctlxmg_exit(2);

UnRegisterCtree(inpbuf);

Limitations

File handles are not shared between instances. Virtual logic cannot close files in other instances.