DBsignaturReturnDrawingkeyEntry

Top  Previous  Next

Investigate of a signature table entry for sign key.

The signature tables of the data bank are multistage lists. There is up to ten signature tables. Every table is a list of entries which is responsible in each case for a certain area of object keys. Each of these lists contains two other 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 sign 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 from 4 to 10 are possible here for it.

dkyIndex (int) [IN]

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

tableData (PDKY_TABLE) [(IN) / OUT]

This pointer must point at a record of the type DKY_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 to take up numSegmente 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 DBsignaturReturnDrawingkeyEntry (

PROOT root,

int table,

int dkyIndex,

PDKY_TABLE tableData,

USHORT * numSegmente,

USHORT * linienArt

);

Related functions

DBsignaturAddAreakeyEntry

DBsignaturAddDrawingkeyEntry

DBsignaturDeleteAreakeyEntry

DBsignaturDeleteDrawingkeyEntry

DBsignaturDeleteTable

DBsignaturFindDrawingkeyEntry

DBsignaturGetTableName

DBsignaturReturnAreakeyEntry

DBsignaturSetTableName