DBgdvReturnLayer

Gets the qualities of a plan from the plan management

In the plan management the co-ordinates of the left lower corner, the co-ordinates of the right upper corner, plan type, plan name, PlanID and level are stored to every plan. These values stand also in the plan itself. To find this and if necessary to compare the values, or to put on anew the plan, the values can be got from the data bank. It is only necessary to the fact, that the plan management with DBgdvOpen was opened and the Layer is known. Then DBgdvReturnLayer determines all the other values and writes them in the Record settings.

Parametre

root (PROOT) [IN]

Act on the open data bank.

layer (int) [IN]

The level whose values are questioned.

settings (GDV_LAYER_SETTINGS *) [IN / OUT]

settings points at a record in which the settings zurückgeliefert become.

grade (int) [IN]

grade must be always put on 1. Grades the choice can be distinguished for later advancements.

gdvName (const char *) [IN]

The name of the plan management. If is gdvName = ZERO, the open plan management is used.

Result

(T_ERROR) [OUT]

If the function ran successfully, the function ERROR_OK delivers back. Otherwise a mistake code from error.h

Declaration

#include "database.h"

T_ERROR DLLENTRY DBgdvReturnLayer (

PROOT root,

int layer,

GDV_LAYER_SETTINGS * settings,

int grades,

const char * gdvName

);

Related functions

DBgdvDeletePlan

A plan from the open plan management remove.

The plan as a file remains available. Only the reference to this from the data banks of the plan management is removed. Because the name of a plan within the plan management must not be unequivocal ANY MORE the name of the plan than searching criterion PERHAPS is not sufficient ANY MORE!!!

Parametre

root (PROOT) [IN]

The trading of the data bank.

flat (char *) [IN]

The name of the plan which should be removed from the plan management. For this purpose the plan must be stored of course in the plan management.

gdvName (const char *) [IN]

The name of the plan management. If is gdvName = ZERO, the open plan management is used.

Result

(T_ERROR) [OUT]

ERROR_OK in case of the perfect treatment. An error message from error.h, otherwise, e.g., if the plan did not exist in the plan management.

Declaration

#include "database.h"

[****]

T_ERROR DLLENTRY DBgdvDeletePlan (

PROOT root,

char * flat,

const char *gdvName

);

[****]