SYSlockSperren

Geo-files close.

So that the files which contain plans cannot be worked on at the same time by several users, they are closed. In the lists where the plans are, a file with the name sperren.dbf exists. This file, in the DBASE format, contains the necessary information about who uses just which file.

Parametre

root (PROOT) [IN]

Act on the open data bank.

realName (char *) [IN]

In realName stands the list name and the file name. With the help of the list name a file with the names sperren.dbf is provided (if yet available) and in it the file name from realName is not put down as a closed file.

wasLocked (int *) [IN / OUT]

wasLocked points on int, this gives whether the file was already closed (TRUE) or now as closed was marked (FALSE).

user (char *) [IN]

If the plan is not closed, he is closed namely with the information which user the plan closes.

wfName (char *) [IN]

In which Workfile the plan just is, it is given with wfName. The list path becomes not costored only of the Workfilename.

surely (char) [IN]

As possible rights 'W' or 'page' exist.

format (char *) [IN]

format gives the plan type, e.g., "DXF" or "DBB". No exam is taken here whether it exists in the format given type, it can be taken also a free name.

blattTyp (int) [IN]

With blattTyp the sheet type in which is the plan is determined.

accessNumber (int *) [IN / OUT]

M_Param_Beschr

userpar (const char *) [IN]

M_Param_Beschr

Barrier info (SPERRE_INFO *) [IN / OUT]

The structure SPERRE_INFO is filled with the user names, Workfilenamen, date and time and the computer names if the plan is already closed.

Result

(int) [OUT]

The routine delivers the constant ERROR_OK as a result if everything ran perfectly. If the plan to be closed is already closed, also becomes ERROR_OK zurückgeliefert and in wasLocked then stands TRUE and in the structure SPERRE_INFO then stands the information of which users, which Workfile which time and date and from which computer this plan was closed.

Declaration

#include "system.h"

int DLLENTRY SYSlockSperren (

PROOT root,

char * realName,

int * wasLocked,

char * user,

char * wfName,

char surely,

char * format,

int blattTyp,

int * accessNumber,

const char * userpar,

SPERRE_INFO * barrier info

);

Related functions

SYSlockEnterAny

SYSlockEntsperren