Web 注册表是一个文件,由 Net.Data 维护此文件的一个关键字,允许您方便地 添加、检索和删除其中的条目。您可以在一个系统中创建多个 Net.Data Web 注册表。每个 注册表有自己的名称,可以包含多个条目。Net.Data 提供了一些函数,用于维护注册表及其 包含的条目。
限制:当使用 OS/2 时,不要把星号(*)作为 registry、registryVariable 和 registryData 参数的值。
AIX | HP-UX | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
X | X | X |
| X | X | X | X |
目的
将一个条目添加至 Web 注册表。
格式
@DTWR_ADDENTRY(registry, registryVariable, registryData, index)
值
数据类型 | 参数 | 用法 | 说明 |
---|---|---|---|
字符串 | registry | IN | 要向其中添加条目的注册表名称。 |
字符串 | registryVariable | IN | 要添加的注册表条目中 registryVariable 字符串 部分的值。 |
字符串 | registryData | IN | 要添加的注册表条目中 registryData 字符串 部分的值。 |
字符串 | index | IN | 要添加的索引项中 registryVariable 字符串 索引部分的值。此参数是可选的。 如果指定此参数,则将一个索引项添加到指定的注册表。 |
例
例 1:
@DTWR_ADDENTRY("Myregistry", "Jones", "http://Advantis.com/~Jones/webproj")
例 2:
@DTWR_ADDENTRY("URLLIST", "SMITH", "http://www.software.ibm.com/", "WORK_URL,")
AIX | HP-UX | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
X | X | X |
| X | X | X | X |
目的
从 Web 注册表中清除条目。
格式
@DTWR_CLEARREG(registry)
值
数据类型 | 参数 | 用法 | 说明 |
---|---|---|---|
字符串 | registry | IN | 要清除的注册表名称。 |
例
例 1:
@DTWR_CLEARREG("Myregistry")
AIX | HP-UX | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
X | X | X |
| X | X | X | X |
目的
创建一个新的 Web 注册表。
Re
格式
@DTWR_CREATEREG(registry, security)
值
数据类型 | 参数 | 用法 | 说明 |
---|---|---|---|
字符串 | registry | IN | 要创建的注册表名称。
限制:Web 注册表名称中不要使用例如星号(*)和反斜线(\)等的特殊字符。 |
字符串 | security | IN | 用以创建 registry 的安全性类型。在 UNIX 操作系 统中,缺省的安全性与注册表所在目录的安全性相同。必须为三个安全性组指定安全性:用户、 组和公共。R 表示具有读许可权,W 表示具有写许可权,而 X 表示具有执行许可权。 例如, 如果要对三个组都指定全部权限,可以指定此参数为 *RWX, *RWX, *RWX。 . |
例
例 1:
@DTWR_CREATEREG("myRegistry")
例 2:
@DTWR_CREATEREG("URLLIST", "*RWX, *RWX, *R")
AIX | HP-UX | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
X | X | X |
| X | X | X | X |
目的
将 Web 注册表删除一个条目。
格式
@DTWR_DELENTRY(registry, registryVariable, index)
值
数据类型 | 参数 | 用法 | 说明 |
---|---|---|---|
字符串 | registry | IN | 要从中移去条目的注册表名称。 |
字符串 | registryVariable | IN | 要移去的条目中 registryVariable 字符串部分的值。 |
字符串 | index | IN | 索引项中 registryVariable 字符串索引部分的值。这是一个可选参数。 如果指定此参数,则从注册表移去索引项。 |
例
例 1:
@DTWR_DELENTRY("Myregistry", "Jones")
例 2:
@DTWR_DELENTRY("URLLIST", "SMITH", "WORK_URL")
AIX | HP-UX | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
X | X | X |
| X | X | X | X |
目的
删除一个 Web 注册表。
格式
@DTWR_DELREG(registry)
值
数据类型 | 参数 | 用法 | 说明 |
---|---|---|---|
字符串 | registry | IN | 要删除的注册表名称。 |
例
例 1:
@DTWR_DELREG("Myregistry")
AIX | HP-UX | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
X | X | X |
| X | X | X | X |
目的
列出整个 Web 注册表。DTWR_LISTREG 返回由用户传递的 OUT 表格变量中的注册表条目信息。此表格变量是在 作为参数传递到 FUNCTION 模块执行 LISTREG 注册表操作以前,在用户宏中定义的。
如果 对于表格中的最大行数,用户使用 ALL 选项来定义表格变量,则此操作列出了表格 中所有可用的注册表条目,每个表格行一个。 另一方面,如果用户指定表格中的最大行数 为值 X, 但在指定的注册表中有多于 X 个条目,则只列出前面的 X 个条目,并发回 一个错误代码,表示由于没有足够的表格行用于列出更多的条目,现在只能列出一个部分 列表。 如果值 X 超过了指定的注册表中的可用条目数,则列出所有条目。
在表格中 总是有两列。 由 Web 注册表语言环境指定表格的列标题 为 "REGISTRY_VARIABLE" 和 "REGISTRY_DATA"。
格式
@DTWR_LISTREG(registry, registryTable)
值
数据类型 | 参数 | 用法 | 说明 |
---|---|---|---|
字符串 | registry | IN | 要列出的注册表名称。 |
字符串 | registryTable | OUT | 用于存放注册表条目的表格变量的名称。 |
例
例 1:
%DEFINE RegistryTable = %TABLE(ALL) @DTWR_LISTREG("URLLIST", RegistryTable)
AIX | HP-UX | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
|
|
|
|
|
|
| X |
目的
列出 Web 注册表中的直接子关键字条目。DTWR_LISTSUB 返回由用户传递的 OUT 表格参数中的注 册表条目信息。此表格变量是在 作为参数传递到 LISTSUBG 注册表操作以前,在用户宏中定义的。
如果 对于表格中的最大行数,用户使用 ALL 选项来定义表格变量,则此操作列出了表格 中所有可用的注册表条目,每个表格行一个条目。另一方面,如果用户指定表格中的最大行数 为值 X, 但在指定的注册表中有多于 X 个条目,则只列出前面的 X 个条目,并发回 一个错误代码,表示由于没有足够的表格行用于列出更多的条目,现在只能列出一个部分 列表。 如果值 X 超过了指定的注册表中的可用条目数,则列出所有条目。 在表格中 总是只有一列。
表格的列标题设置为 "REGISTRY_SUBKEY"。
只有在与 Windows95 “系统注册表”兼容的操作系统中,此函数才有效。
格式
@DTWR_LISTSUB(registry, registryTable)
值
数据类型 | 参数 | 用法 | 说明 |
---|---|---|---|
字符串 | registry | IN | 要列出的注册表名称。 |
字符串 | registryTable | OUT | 用于存放注册表条目的表格变量的名称。 |
例
例 1:
%DEFINE RegistryTable = %TABLE(ALL) @DTWR_LISTSUB("URLLIST", RegistryTable)
AIX | HP-UX | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
X | X | X |
| X | X | X | X |
目的
从 Web 注册表条目中检索 registryData 字符串。
格式
@DTWR_RTVENTRY(registry, registryVariable, registryData, index)
@DTWR_rRTVENTRY(registry, registryVariable, index)
值
数据类型 | 参数 | 用法 | 说明 |
---|---|---|---|
字符串 | registry | IN | 要在其中检索条目的注册表名称。 |
字符串 | registryVariable | IN | 针对检索其 registerData 字符串的注册表项,它的 registryVariable 字符串部分的值。 |
字符串 | registryData | OUT | 返回注册表项 registryData 字符串部分的值,此注册表项和 registryVariable匹配。 |
字符串 | index | IN | 一个索引项中registryVariable 字符串的索引部 分的值,此索引项的 registryData 字符串被返回。这是一个可选参数。 如果指定此参数, 则返回索引项的 registryData 字符串。 |
例
例 1:
%DEFINE RegistryData = "" @DTWR_RTVENTRY("Myregistry", "Jones", RegistryData)
例 2:
@DTWR_RTVENTRY("URLLIST", "SMITH", RegistryData, "WORK_URL")
例 3:
@DTWR_rRTVENTRY("Myregistry", "Jones")
例 4:
@DTWR_rRTVENTRY("URLLIST", "SMITH", "WORK_URL")
AIX | HP-UX | OS/2 | OS/390 | OS/400 | SCO | SUN | Win NT |
X | X | X |
| X | X | X | X |
目的
将指定的注册表条目中现有的 registryData 字符串替换为由调用者指定的新值。registerVariable 字符串不能更改。
格式
@DTWR_UPDATEENTRY(registry, registryVariable, newData, index)
值
数据类型 | 参数 | 用法 | 说明 |
---|---|---|---|
字符串 | registry | IN | 要更新其条目的注册表的名称。 |
字符串 | registryVariable | IN | 要更新的注册表条目 registryVariable 字符串部分 的值。 |
字符串 | newData | IN | 给要更新的注册表条目 registryData 字符串部分 的新值。 |
字符串 | index | IN | 在要更新的索引项中 registryVariable 字符串索引 部分的值。这是一个可选参数。 如果指定此参数,则更新索引条目。 |
例
例 1:
@DTWR_UPDATEENTRY("Myregistry", "Jones", "http://advantis.com/~Jones/personal")
例 2:
@DTWR_UPDATEENTRY("URLLIST", "SMITH", "http://www.software.ibm.com/personal", "WORK_URL")