IBM Books

Net.Data 参考


Web 注册表函数

Web 注册表是一个文件,由 Net.Data 维护此文件的一个关键字,允许您方便地 添加、检索和删除其中的条目。您可以在一个系统中创建多个 Net.Data Web 注册表。每个 注册表有自己的名称,可以包含多个条目。Net.Data 提供了一些函数,用于维护注册表及其 包含的条目。

限制:当使用 OS/2 时,不要把星号(*)作为 registryregistryVariableregistryData 参数的值。

DTWR_ADDENTRY


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)


表 93. DTWR_ADDENTRY 参数
数据类型 参数 用法 说明
字符串 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,")

DTWR_CLEARREG


AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X
X X X X

目的

从 Web 注册表中清除条目。

格式

@DTWR_CLEARREG(registry)


表 94. DTWR_CLEARREG 参数
数据类型 参数 用法 说明
字符串 registry IN 要清除的注册表名称。

例 1

@DTWR_CLEARREG("Myregistry")
 

DTWR_CREATEREG


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)


表 95. DTWR_CREATEREG 参数
数据类型 参数 用法 说明
字符串 registry IN 要创建的注册表名称。

限制:Web 注册表名称中不要使用例如星号(*)和反斜线(\)等的特殊字符。

字符串 security IN 用以创建 registry 的安全性类型。在 UNIX 操作系 统中,缺省的安全性与注册表所在目录的安全性相同。必须为三个安全性组指定安全性:用户、 组和公共。R 表示具有读许可权,W 表示具有写许可权,而 X 表示具有执行许可权。 例如, 如果要对三个组都指定全部权限,可以指定此参数为 *RWX, *RWX, *RWX。 .

例 1

@DTWR_CREATEREG("myRegistry")
 

例 2

@DTWR_CREATEREG("URLLIST", "*RWX, *RWX, *R")

DTWR_DELENTRY


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)


表 96. DTWR_DELENTRY 参数
数据类型 参数 用法 说明
字符串 registry IN 要从中移去条目的注册表名称。
字符串 registryVariable IN 要移去的条目中 registryVariable 字符串部分的值。
字符串 index IN 索引项中 registryVariable 字符串索引部分的值。这是一个可选参数。 如果指定此参数,则从注册表移去索引项。

例 1

@DTWR_DELENTRY("Myregistry", "Jones")

例 2

@DTWR_DELENTRY("URLLIST", "SMITH", "WORK_URL")

DTWR_DELREG


AIX HP-UX OS/2 OS/390 OS/400 SCO SUN Win NT
X X X
X X X X

目的

删除一个 Web 注册表。

格式

@DTWR_DELREG(registry)


表 97. DTWR_DELREG 参数
数据类型 参数 用法 说明
字符串 registry IN 要删除的注册表名称。

例 1

@DTWR_DELREG("Myregistry")

DTWR_LISTREG


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)


表 98. DTWR_LISTREG 参数
数据类型 参数 用法 说明
字符串 registry IN 要列出的注册表名称。
字符串 registryTable OUT 用于存放注册表条目的表格变量的名称。

例 1

%DEFINE RegistryTable = %TABLE(ALL)
 
@DTWR_LISTREG("URLLIST", RegistryTable)

DTWR_LISTSUB


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)


表 99. DTWR_LISTSUB 参数
数据类型 参数 用法 说明
字符串 registry IN 要列出的注册表名称。
字符串 registryTable OUT 用于存放注册表条目的表格变量的名称。

例 1

%DEFINE RegistryTable = %TABLE(ALL)
 
@DTWR_LISTSUB("URLLIST", RegistryTable)

DTWR_RTVENTRY


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)


表 100. DTWR_RTVENTRY 参数
数据类型 参数 用法 说明
字符串 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")

DTWR_UPDATEENTRY


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)


表 101. DTWR_UPDATEENTRY 参数
数据类型 参数 用法 说明
字符串 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")


[ 页的顶部 | 上一页 | 下一页 | 目录 | 索引 ]