APL Wiki|
Size: 2577
Comment: Restrictions emphasized
|
Size: 3057
Comment:
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 2: | Line 2: |
| {{{WinReg}}} is part of the CategoryAplApl project. | {{{WinReg}}} is part of the CategoryAplTree project. |
| Line 30: | Line 30: |
| DeleteSubKey DeleteValue DoesKeyExist DoesValueExist GetString GetValue PutString PutValue Version |
Close CopyTree Copyright DeleteSubKey DeleteSubKeyTree DeleteValue DoesKeyExist DoesValueExist GetAllSubKeyNames GetAllValueNames GetAllValues GetErrorAsStringFrom GetString GetTree GetTreeWithValues GetTypeAsStringFrom GetValue History KeyInfo OpenAndCreateKey OpenKey PutBinary PutString PutValue Version |
| Line 45: | Line 62: |
| * `GetValue` as well as `SetValue` support at present only DWORDs (REG_DWORD) * `GetString` as well as `PutString` support at present only string (REG_SZ) |
* `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. |
| Line 48: | Line 67: |
| Other data types can be requested via `GetValue`; however, writing them is not supported. | |
| Line 49: | Line 69: |
| == History == For a full version history: [[WinReg/History|History]] |
== Project Page == For bug reports, future enhancements and a full version history see WinReg/ProjectPage |
| Line 56: | Line 76: |
| ||Current state: ||1.3.0 || | ||Current state: ||2.2.0 || |
| Line 69: | Line 89: |
| 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 72: | Line 91: |
| CategoryAplApl | CategoryAplTree |
Dealing with the Windows Registry
WinReg is part of the CategoryAplTree project.
Contents
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
Close CopyTree Copyright DeleteSubKey DeleteSubKeyTree DeleteValue DoesKeyExist DoesValueExist GetAllSubKeyNames GetAllValueNames GetAllValues GetErrorAsStringFrom GetString GetTree GetTreeWithValues GetTypeAsStringFrom GetValue History KeyInfo OpenAndCreateKey OpenKey PutBinary PutString PutValue Version
Restrictions
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.
Project Page
For bug reports, future enhancements and a full version history see WinReg/ProjectPage
Version Information
Original author: |
|
Responsible: |
|
Email: |
|
Current state: |
2.2.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