Registry API calls

There are a number of functions to set and retrieve registry entries in the UPDD branch. See the individual calls for more information.

 

API Call

Description

TBApiGetSettingDWORD

Get DWORD setting

TBApiSetSettingDWORD

Set DWORD setting

TBApiGetSettingSZ

Get String setting

TBApiSetSettingSZ

Set String setting

TBApiGetGlobalSettingDWORD

Get global DWORD setting

TBApiSetGlobalSettingDWORD

Set global DWORD setting

 

There are also extended versions of the above that allow a named sub-tree and node to be accessed:

 

TBApiGetSettingSZEx

Extended get String setting

TBApiSetSettingSZEx

Extended set String setting

TBApiGetSettingDWORDEx

Extended get DWORD setting

TBApiSetSettingDWORDEx

Extended set DWORD setting

 

Some of these API's perform special processing that may be extended in future releases. For example, for TBApiSetSettingSZEx, if the aName argument is set to "Calibration Style" and aSubtree equals "", the indicated style (in argument aSZ) is activated. e.g. for calibration styles - use aSubTree = "" to emulate the "non-extended" versions

 

The following example shows the settings that make up a typical UPDD subtree:

 

HKLM\System\CurrentControlSet\Services\TBUPDD\ ->

...\{....}\Parameters\1\Number Of Calibration Styles - item count 

...\{....}\Parameters\1\Calibration Style - active item name

...\{....}\Parameters\1\Calibration Styles\0\Calibration Style - item name

...\{....}\Parameters\1\Calibration Styles\0\... - other item data

 

These calls work exactly the same in all OS environments. In Windows they access the registry whereas in other operating systems they access the files holding the registry structure.