DBsaveSelection

Top  Previous  Next

The topical selection list protect.

Here the word Securing is to be understood in the sense that not data are really protected on the data carrier, but are interstored only for temporary changes.

A selection state is protected for the later use. The user gets back a trading on this selection list. With this trading and with the Routiner DBrestoreSelection if the secure selection list can be restored. Then exactly the objects which were selected by call by DBsaveSelection are selected. All objects should again exist, because only one limited check occurs. Several selection amounts can be held at the same time, while with DBsaveSelection in each case a new trading is requested. If a selection list is not required any more, it was supposed to come too DBdestroySelection are destroyed to release the memory occupied by this list.

The selection amounts which have been protected cannot be worked on. To work with a secure selection amount, the topical one must be protected first and the before secure one has to come too DBrestoreSelection again when topical amount are produced.

Parametre

root (PROOT) [IN]

Act to the data bank whose selection state should be protected.

Result

(SELECTION_LIST) [OUT]

A trading for this selection state. With this trading the momentary state can be restored any time. The trading will leave with the fastening of the data bank (from Moskito) invalid, cannot be protected permanently.

Declaration

#include "database.h"

 

SELECTION_LIST DLLENTRY DBsaveSelection (

PROOT root

);

Related procedures

DBdestroySelection

DBrestoreSelection