Synopsis

(macro) PDX_MSGT mda_ReserveEntity(long option, MDA_PTR *db_ptr)

Purpose

Reserve a new entity in the current model.

Description

A database pointer will be reserved for future use. The reserved database pointer can be allocated as an entity by using the MDA_RESERVED option to mda_AllocateEntity, mda_AllocateEntity2, or mda_CreateEntity. Until the entity has been allocated with one of these functions, it will not actually exist in the database. Thus the reserved pointer will not be passed to a function called from mda_TraverseModel and can not be locked or used in any way until it has been allocated.

Input

option

Options (not used)

Output

db_ptr

The reserved database pointer.

Return

MDA error code