Prototype and description of the function setsilence()

(This function needs no unlocking)

 

setsilence()
Switching of the target for GeoDLL messages as MessageBox or in the EventLog.

Prototype of the DLL function in C++ syntax (attend lower case!):
extern "C" __declspec(dllimport) unsigned long __stdcall setsilence(
     unsigned long lSwitch);

Prototype of the DLL function in Visual Objects syntax:
_DLL function setsilence(;
     lSwitch as logic);                    // 4 Byte
as logic pascal:geodll32.setsilence        // 4 Byte


Errors, that adversely affect the operation of the GeoDLL, will be displayed
to the user as messages. The function setsilence() switches the output of
GeoDLL messages in the EventLog on or off. By default GeoDLL messages are
shown at run time in MessageBox dialogs. A program that runs in a service
(e.g. SQL server) or in batch, may not open a dialog. Here it is better to
register the GeoDLL messages in the EventLog.

If in lSwitch the value TRUE is passed, the GeoDLL messages will be written
to the EventLog.

If in lSwitch the value FALSE is passed, the GeoDLL messages will be shown
in MessageBox dialogs on the program surface.

After starting the program run and loading of the DLL, the output of GeoDLL
messages ot the EventLog is switched off as default. The messages then are
shown as MessageBox dialogs.

The entries of the EventLog can be viewed in the Event Viewer:
"Start / Control Panel / Performance and Maintenance / Event Viewer".
In the Event Viewer open the folder "Applikation".
Search entries with the source "GeoDLL xx.xx" and double click them.
Im the lower part of the description you find the warning or the error note.

There are further switches, which prepare GeoDLL for the operating in
different environments. These are the functions
      setinternerrsys()
      setstringallocate()
      setmultithreading()
      setstaticuse()


The parameters are passed and/or returned as follows:
lSwitch       Switch for the output target of GeoDLL messages.
TRUE          Output of GeoDLL messages in the EventLog.
FALSE         Output of GeoDLL messages in MessageBox dialogs.
              (default)

returnVal     In case of an error the function returns FALSE, otherwise TRUE.


Unlocking
This function needs no unlocking.