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. |