Download AppSrvCE User Manual
Transcript
Introduction 7000-ADM ♦ AppSrvCE Application Development Module DWORD value RegistryLock under the key HKEY_LOCAL_MACHINE\Software\Online Development\SaveReg to 0. The Utility API includes functions that can be used by an application to manipulate the registry lock. Refer to the Utility API section for more information. Utility API The Utility API contains several functions that applications can use to simplify tasks such as unlocking the registry, flushing registry changes to disk, and rebooting the system. To use the Utility API, include the header file ceutilapi.h and link with the import library ceutilapi.lib. The following functions are included in the Utility API: int UTL_IsRegistryUnlocked(); This function returns the status of the registry lock. The valid return values are listed below: 0 The registry is locked. 1 The registry is temporarily unlocked (it will revert back to locked after a reboot). 2 The registry lock is disabled (the RegistryLock value in the registry is set to 0). int UTL_UnlockRegistryNextBoot(); This function arms the registry unlock feature so the registry will be temporarily unlocked after the next system reboot. int UTL_SaveRegistry(); If the registry is unlocked, this function will flush any registry updates to disk. If the registry is locked, this function has no effect. int UTL_Reboot(); This function will shutdown and reboot the system. AppSrv Configuration Utility (TCU) TCU is a console-mode utility that can be used to setup basic security and network configuration. It can be run from a command prompt, remotely over the network via telnet, or even over a serial port. It was primarily designed to ease configuration of headless units. If enabled, TCU will monitor serial port COM1 for a carriage return character (0x0D) for a predefined period of time after boot. If the CR is received, the configuration menu will be displayed. By default, this feature of TCU is disabled on AppSrv. To enable the serial-port feature of TCU, the following DWORD registry values must be set under the key HKEY_LOCAL_MACHINE\Drivers\Console: EnableTcu = 1 (1 to enable TCU on COM1, 0 to disable) ComSpeed = 38400 (baud rate) TcuWait = 30 (seconds to monitor port after boot) ProSoft Technology, Inc. February 20, 2007 Page 13 of 64