How To Write to the Windows Registry Using API Calls

• Microsoft Visual FoxPro for Windows, versions 3.0, 5.0

SUMMARY

You can write information directly to the Windows 95, Windows NT, or Win32 Registry. The Windows Registry is the suggested place for 32-bit applications to store application information. Previous versions of Windows used .INI files for this purpose. This article gives a brief description of the Windows Registry and the steps necessary to write information to it programatically.

MORE INFORMATION

The following information comes from Chapter 10 of the Windows NT Resource Kit:

   The Registry is analogous to the .INI files used under Windows 3.1, with
   each key in the Registry similar to a bracketed heading in an .INI file,
   and entries under the heading similar to values in the Registry.
   However, Registry keys can contain subkeys, while .INI files do not
   support nested headings. Registry values can also consist of executable
   code, rather than the simple strings representing values in .INI files.
   And individual preferences for multiple users of the same computer can
   be stored in the Registry, which is not possible with .INI files.

Windows NT Registry

The Registry is a database of keys and values. The Windows NT Registry contains four primary keys:

HKEY_CLASSES_ROOT   - File associations and DDE/OLE actions.

                      computer.

HKEY_USERS          - Configuration information about each individual user
                      of the computer and the DEFAULT entry.

HKEY_CURRENT_USER   - specific key within HKEY_USERS that stores
                      information for the currently active user.

Windows 95 Registry

Windows 95 adds a couple more primary keys:

HKEY_CURRENT_CONFIG - Hardware configuration for devices currently attached

                      and installed on the computer.

HKEY_DYN_DATA       - System Monitor data for performance settings and
                      statistics.

   SOFTWARE\Vendor\product\version

Win32s Registry

The Win32s Registry is limited to only one hive, HKEY_CLASSES_ROOT, and all keys are children of that hive. Any information placed in the Win32s Registry should be placed in a child key of HKEY_CLASSES_ROOT instead of HKEY_CLASSES_ROOT (used in Windows 95 and Windows NT).

Sample Code

The following code illustrate the ability to create a new registry key by using the Windows API RegCreateKeyEx() and to assign a value to that key by using RegSetValueEx. These 32bit functions are first prototyped using the DECLARE command; then they are available to be called directly. For more information, please search for DECLARE - DLL in the Help menu.

NOTE: Some constants are declared with definitions taken from the appropriate Microsoft Visual C++ header files.

* REGISTRY.PRG * This code writes information to the HKEY_LOCAL_MACHINE\SOFTWARE key. * It creates a key called MYAPPS, and a value name called AppName that * contains the value "SuperApp 1.0"

PUBLIC RESULT,DISPLAY RESULT=0 DISPLAY=0

#DEFINE HKEY_LOCAL_MACHINE 2147483650   && (HKEY) 0x80000002
#DEFINE SECURITY_ACCESS_MASK 983103     && SAM value KEY_ALL_ACCESS

?RegCreateKeyEx(HKEY_LOCAL_MACHINE,"SOFTWARE\MYAPPS",0,"REG_SZ",; 0,SECURITY_ACCESS_MASK,0,@RESULT,@DISPLAY) && Returns .T. if successful

?RESULT                                     && Returns the key handle
?DISPLAY                                    && Returns one of 2 values:
                                            && REG_CREATE_NEW_KEY = 1
                                            && REG_OPENED_EXISTING_KEY = 2

Notes

You can run the Registry Editor to see the registry interface and check that your key was created successfully in the HKEY_LOCAL_MACHINE\SOFTWARE section. In Windows NT, you can find it in the Winnt\System32\regedt32.exe directory. In Windows 95, you can find it in the Win95\Regedit.exe directory.

For more information, please see the Win32API Help file shipped with Visual FoxPro. Search for RegCreateKeyEx() and RegSetValueEx() as well as the Reg.h and Winnt.h header files to find some of the constant definitions used in the code. To remove these values, you can use the RegDeleteKey() and RegDeleteValue() functions.