APL Wiki|
Size: 2960
Comment:
|
Size: 2195
Comment:
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 1: | Line 1: |
| ## page was copied from WinReg = Dealing with the Windows Registry = {{{WinReg}}} is part of the CategoryAplTree project. |
= WinRegSimple: dealing with the Windows Registry = {{{WinRegSimple}}} is part of the CategoryAplTree project. |
| Line 8: | Line 7: |
| This class offers methods useful to deal with the Windows Registry without using .NET. It uses `⎕NA` calls to the appropriate Windows API. | This class offers a limited range of methods useful to read, write and delete values from the Windows Registry without using .NET. It uses the [[https://en.wikipedia.org/wiki/Windows_Script_Host|Windows Scripting Host]]. |
| Line 10: | Line 9: |
| `WinReg` is a powerful class that offers plenty of methods. If you just want to read, write and/or delete values from the Windows Registry then the much smaller class [[WinRegSimple]] might be sufficient. | For an all-singing-all-dancing class see [[WinReg]] which is much more powerful. However, `WinReg` is a complex and large class. If `WinRegSimple` offers what you need stick with it. |
| Line 38: | Line 37: |
| Close CopyTree DeleteSubKey DeleteSubKeyTree DeleteValue DoesKeyExist DoesValueExist Close CopyTree Copyright DeleteSubKey DeleteSubKeyTree DeleteValue DoesKeyExist DoesValueExist GetAllSubKeyNames GetAllValueNames GetAllValues GetDyalogRegPath GetErrorAsStringFrom GetString GetTree GetTreeWithValues GetTypeAsStringFrom GetValue History KeyInfo ListError ListReg OpenAndCreateKey OpenKey PutBinary PutString PutValue ReadByte |
Read Write Delete |
| Line 77: | Line 44: |
| Note the following restrictions: * `PutValue` supports DWORDs (REG_DWORD) * `PutBinary` supports REG_BINARY * `PutString` and `GetString` support strings (REG_SZ), nested strings (REG_MULTI_SZ) and expanded strings (REG_EXPAND_SZ) * `GetValue` supports all data types. Other data types can be requested via `GetValue`; however, writing them is not supported. |
The `Write` method supports just two data types: REG_SZ and REG_DWORD. |
| Line 87: | Line 47: |
| For bug reports, future enhancements and a full version history see WinReg/ProjectPage | For bug reports, future enhancements and a full version history see WinRegSimple/ProjectPage |
WinRegSimple: dealing with the Windows Registry
WinRegSimple is part of the CategoryAplTree project.
Contents
Overview
This class offers a limited range of methods useful to read, write and delete values from the Windows Registry without using .NET. It uses the Windows Scripting Host.
For an all-singing-all-dancing class see WinReg which is much more powerful. However, WinReg is a complex and large class. If WinRegSimple offers what you need stick with it.
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 therefore defines the standard. That is the reason why I decided to go for it: it makes it easier to understand the Microsoft documentation but also to understand others while talking about the Windows Registry.
In this picture:
you can see this string:
HKEY_CURRENT_USER\Software\Dyalog\Dyalog APL/W 12.0 Unicode\AutoComplete
at the top of the window.
HKEY_CURRENT_USER
This is called a "Main key". There are a number of pre-defined main keys available you can choose from. 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 sub key.
On the right side you see a list. The entries in this list are called "values". Therefore CancelKey1 is a value.
Note that the names are called values; the actual data saved under a value is called "data".
Shared Methods
Read Write Delete
Restrictions
The Write method supports just two data types: REG_SZ and REG_DWORD.
Project Page
For bug reports, future enhancements and a full version history see WinRegSimple/ProjectPage
Version Information
Original author: |
|
Responsible: |
|
Email: |