DBsignaturReturnAreakeyEntry

Top  Previous  Next

Investigate of a signature table entry for surface key.

The signature tables of the data bank are multistage lists. There are three agreed signature tables. Furthermore tables are still free of from 4 to 10. Every table is a list of entries which is responsible in each case for a certain area of object keys. Two other lists contain each of these lists. One list contains entries for surface key, the other entries for sign key.

This procedure delivers the data from an element of the list for surface key back.

Parametre

root (PROOT) [IN]

The trading of the data bank in which the signature tables are loaded.

tabelle (int) [IN]

If one of ten possible tables selects. The worth BILDSCHIRM_SIGNATUR_TABELLE, PLOTTER_SIGNATUR_TABELLE and ORIGINAL_BILDSCHIRM_SIGNATUR_TABELLE and the values of from 4 to 10 are possible here for it.

dkaIndex (int) [IN]

In the untertable the entries are arranged sequential for the single surface keys. The entry is delivered as a result which stands in this list here dkaIndex and the first entry has the index 1.

tableData (PDKA_TABLE) [(IN) / OUT]

This pointer must point at a record of the type DKA_TABLE. He is filled by this procedure with the data of the given entry. If a mistake has appeared, the record is not filled.

numSegmente (USHORT *) [IN / OUT]

IN: By entry into this procedure the variable contains the maximum number of segments which fits in the field linienArt.

OUT: The procedure puts down here the real segment number which has been put down on the field linienArt. If more segments exist than in numSegmente given, the new value is put down in numSegmente.

linienArt (USHORT *) [(IN) / OUT]

This field must point at a storage area which is able, numSegmente-To take up values of the type USHORT. Here the lengths of the line segments with which the lines should be drawn by this type are put down by the procedure.

Result

(T_ERROR) [OUT]

As a result delivers this procedure ERROR_OK if no mistake has appeared, but one of the error messages from the file error.h is delivered as a result.

Declaration

#include "database.h"

 

T_ERROR DLLENTRY DBsignaturReturnAreakeyEntry (

PROOT root,

int tabelle,

int dkaIndex,

PDKA_TABLE tableData,

USHORT * numSegmente,

USHORT * linienArt

);

Related functions

DBsignaturAddAreakeyEntry

DBsignaturAddDrawingkeyEntry

DBsignaturDeleteAreakeyEntry

DBsignaturDeleteDrawingkeyEntry

DBsignaturDeleteTable

DBsignaturFindDrawingkeyEntry

DBsignaturGetTableName

DBsignaturReturnDrawingkeyEntry

DBsignaturSetTableName