Differences between revisions 5 and 20 (spanning 15 versions)

Dealing with the Windows Registry

WinReg is part of the CategoryAplApl project.

Contents

Dealing with the Windows Registry

Overview

This class offers methods useful to deal with the Windows Registry without using .NET.

Terminology

To understand the names of the methods you need to understand the terminology. If you find the terminology strange: so do I, but it was invented by Microsoft and got widely accepted. That is the reason why I decided to go for it: it makes it easier to understand others while talking about the Windows Registry.

In this picture:

you can see that this string is visible in the top of the window:

HKEY_CURRENT_USER\Software\Dyalog\Dyalog APL/W 12.0 Unicode\AutoComplete

HKEY_CURRENT_USER

This is called a "Main key". There is a particular number of pre-defined main keys available you can choose from. For the most important one from an application programmers view there is also a shortcut available: Instead of HKEY_CURRENT_USER you can use HKCU.

SOFTWARE\Dyalog\Dyalog APL/W 12.0 Unicode

This is called a subkey.

On the right side you see a list. The entries in this list are called "value". CancelKey1 is there a value. The actual data saved under this value is called "data".

Shared Methods

DeleteSubKey
DeleteValue
DoesKeyExist
DoesValueExist
GetString
GetValue
PutString
PutValue
Version

Restrictions

Note the following restrictions:

GetValue as well as SetValue support at present only DWORDs (REG_DWORD)
GetString as well as PutString support at present only string (REG_SZ)

History

For a full version history: History

Version Information

Original author:	KaiJaeger
Responsible:	KaiJaeger
Email:	kai@aplteam.com
Current state:	1.3.0

Download

You have two options: you can either download the script for usage:

Download WinReg script right now

or get the whole thing from the AplWikiRepository, including the development workspace and the script and maybe more for any development or for running the test cases:

svn list svn://aplteam.com/os/dyalog/WinReg/tags

If you plan to contribute please note that all stuff published as part of the APLAPL project must follow certain APLAPL-specific standards.

CategoryAplApl

-  ⇤ ← Revision 5 as of 2008-07-26 21:36:55 → 
  Size: 1788
  Editor: KaiJaeger
  Comment:
+   ← Revision 20 as of 2011-01-21 18:41:38 → ⇥
  Size: 2577
  Editor: KaiJaeger
  Comment: Restrictions emphasized
-Deletions are marked like this.
+Additions are marked like this.
 Line 2:
+{{{WinReg}}} is part of the CategoryAplApl project.
-Line 3:
+Line 4:
-[[TableOfContents]]
+<<TableOfContents>>
-Line 6:
+Line 7:
 Line 10:
-Line 15:
+Line 14:
-[[ImageLink(EditReg.jpg)]]
+[[attachment:EditReg.jpg|{{attachment:EditReg.jpg|attachment:EditReg.jpg}}]]
-Line 22:
+Line 21:
-Line 26:
+Line 24:
-Line 32:
+Line 29:
+{{{
DeleteSubKey
DeleteValue
DoesKeyExist
DoesValueExist
GetString
GetValue
PutString
PutValue
Version
}}}
-Line 33:
+Line 41:
- * !DeleteSubKey
 * !DeleteValue
 * !DoesKeyExist
 * !DoesValueExist
 * !GetString
 * !GetValue
 * !PutString
 * !PutValue
 * Version
+== Restrictions ==

Note the following restrictions:

 * `GetValue` as well as `SetValue` support at present only DWORDs (REG_DWORD)
 * `GetString` as well as `PutString` support at present only string (REG_SZ)
-Line 45:
+Line 50:
-For a full version history: [:WinReg/History: History]
+For a full version history: [[WinReg/History|History]]
-Line 49:
+Line 53:
+||Original author: ||KaiJaeger ||
||Responsible: ||KaiJaeger ||
||Email: || kai@aplteam.com ||
||Current state: ||1.3.0 ||
-Line 50:
+Line 58:
-||Original author:||KaiJaeger||
||Responsible:||KaiJaeger||
||Email:||kai@aplteam.com||
||Current state:||1.0||
-Line 56:
+Line 60:
-Goto the [:WinRegDownloadPage:WinRegDownloadPage]
+You have two options: you can either download the script for usage:

[[http://aplwiki.com/WinReg?action=AttachFile&do=get&target=WinReg.ZIP|Download WinReg script right now]]

or get the whole thing from the AplWikiRepository, including the development workspace and the script and maybe more for any development or for running the test cases:

{{{
svn list svn://aplteam.com/os/dyalog/WinReg/tags
}}}
If you plan to contribute please note that all stuff published as part of the APLAPL project must follow certain [[AplAplStandards|APLAPL-specific standards]].
-Line 59:
+Line 72:
-CategoryOpenSourceApl CategoryAplAplDyalog
+CategoryAplApl