KKmail 邮件组件参考手册 |
RegAccess 对象 |
|
RegAccess 对象是 KKmail 辅助对象之一,本对象主要实现对 Windows 的注册表进行读写等操作。 |
|
属性列表 |
本对象不存在属性项。
|
方法 |
- CreateNewKey
语法: CreateNewKey psRootPath, psSubKey
描述: 创建一个子项,如果该子项已经存在,则不进行任何操作
返回: 0 创建成功; 非 0 数值为创建失败, 并返回错误代码
参数:
参数 |
数据类型 |
描述 |
psRootPath |
字符串 |
注册表的根键,必须要选择系统中存在的根键名称,如"HKEY_LOCAL_MACHINE"。 |
psSubKey |
字符串 |
需要创建的注册表的子项与路径,其中该子项与路径是不包含注册表的根键名称的。 |
|
- QueryKeyExist
语法: QueryKeyExist psRootPath, psSubKey
描述: 查询一个子项是否存在
返回: 1 该子项存在; 0 该子项不存在
参数:
参数 |
数据类型 |
描述 |
psRootPath |
字符串 |
注册表的根键,必须要选择系统中存在的根键名称,如"HKEY_LOCAL_MACHINE"。 |
psSubKey |
字符串 |
需要查询的注册表的子项与路径,其中该子项与路径是不包含注册表的根键名称的。 |
|
- DeleteKey
语法: DeleteKey psRootPath, psSubKey, psRemoveKeyName
描述: 删除一个子项
返回: 0 删除成功; 非 0 数值为删除失败, 并返回错误代码
参数:
参数 |
数据类型 |
描述 |
psRootPath |
字符串 |
注册表的根键,必须要选择系统中存在的根键名称,如"HKEY_LOCAL_MACHINE"。 |
psSubKey |
字符串 |
需要删除的注册表子项所在的路径,其中该路径是不包含注册表的根键名称的。 |
psRemoveKeyName |
字符串 |
需要删除的注册表子项名称,其中该子项名称是不包含注册表的根键名称的以及路径名称。 |
|
- SetKeyValueSZ
语法: SetKeyValueSZ psRootPath, psSubKey, psValueName, psValue
描述: 在一个子项下设置一个字符串值项
返回: 0 设置成功; 非 0 数值为设置失败, 并返回错误代码
参数:
参数 |
数据类型 |
描述 |
psRootPath |
字符串 |
注册表的根键,必须要选择系统中存在的根键名称,如"HKEY_LOCAL_MACHINE"。 |
psSubKey |
字符串 |
需要设置的注册表子项与路径,其中该子项与路径是不包含注册表的根键名称的。 |
psValueName |
字符串 |
需要设置的值项名称,如果值项名称为空,则为"(默认)"项。 |
psValue |
字符串 |
需要设置的值。 |
|
- SetKeyValueDWORD
语法: SetKeyValueDWORD psRootPath, psSubKey, psValueName, plValue
描述: 在一个子项下设置一个 DWORD 值项
返回: 0 设置成功; 非 0 数值为设置失败, 并返回错误代码
参数:
参数 |
数据类型 |
描述 |
psRootPath |
字符串 |
注册表的根键,必须要选择系统中存在的根键名称,如"HKEY_LOCAL_MACHINE"。 |
psSubKey |
字符串 |
需要设置的注册表子项与路径,其中该子项与路径是不包含注册表的根键名称的。 |
psValueName |
字符串 |
需要设置的值项名称,如果值项名称为空,则为"(默认)"项。 |
plValue |
整数 |
需要设置的值。 |
|
- QueryKeyValueSZ
语法: QueryKeyValueSZ psRootPath, psSubKey, psValueName
描述: 查询一个子项下某一个字符串型的值项的值
返回: 对应值项的字符串值
参数:
参数 |
数据类型 |
描述 |
psRootPath |
字符串 |
注册表的根键,必须要选择系统中存在的根键名称,如"HKEY_LOCAL_MACHINE"。 |
psSubKey |
字符串 |
需要查询的注册表子项与路径,其中该子项与路径是不包含注册表的根键名称的。 |
psValueName |
字符串 |
需要查询的值项名称,如果值项名称为空,则为"(默认)"项。 |
|
- QueryKeyValueDWORD
语法: QueryKeyValueDWORD psRootPath, psSubKey, psValueName
描述: 查询一个子项下某一个 DWORD 型的值项的值
返回: 对应值项的 DWORD 值,返回对应的整数
参数:
参数 |
数据类型 |
描述 |
psRootPath |
字符串 |
注册表的根键,必须要选择系统中存在的根键名称,如"HKEY_LOCAL_MACHINE"。 |
psSubKey |
字符串 |
需要查询的注册表子项与路径,其中该子项与路径是不包含注册表的根键名称的。 |
psValueName |
字符串 |
需要查询的值项名称,如果值项名称为空,则为"(默认)"项。 |
|
- QueryValueNameExist
语法: QueryValueNameExist psRootPath, psSubKey, psValueName
描述: 查询一个子项下某个值项是否存在
返回: 0 查询失败,或值项不存在,或该值项数据为"未设置" 1 存在字符串类型(REG_SZ)的值项 4 存在DWORD类型(REG_DWORD)的值项
参数:
参数 |
数据类型 |
描述 |
psRootPath |
字符串 |
注册表的根键,必须要选择系统中存在的根键名称,如"HKEY_LOCAL_MACHINE"。 |
psSubKey |
字符串 |
需要查询的注册表子项与路径,其中该子项与路径是不包含注册表的根键名称的。 |
psValueName |
字符串 |
需要查询的值项名称,如果值项名称为空,则为"(默认)"项。 |
|
- DeleteValueName
语法: DeleteValueName psRootPath, psSubKey, psValueName
描述: 删除一个子项下某个值项
返回: 0 删除成功; 非 0 数值为删除失败, 并返回错误代码
参数:
参数 |
数据类型 |
描述 |
psRootPath |
字符串 |
注册表的根键,必须要选择系统中存在的根键名称,如"HKEY_LOCAL_MACHINE"。 |
psSubKey |
字符串 |
需要删除的注册表子项与路径,其中该子项与路径是不包含注册表的根键名称的。 |
psValueName |
字符串 |
需要删除的值项名称,如果值项名称为空,则为"(默认)"项。 |
|
示例 [显示↓] |
Dim Rc As Long
Dim myRegAccess As Object
Set myRegAccess = CreateObject("KKmail.RegAccess")
'创建一个新的路径
Rc = myRegAccess.CreateNewKey("HKEY_LOCAL_MACHINE", "SOFTWARE\MailerDeeSystem\KKmail\1.0")
'设置一个字符串值项
Rc = myRegAccess.SetKeyValueSZ("HKEY_LOCAL_MACHINE", "SOFTWARE\MailerDeeSystem\KKmail", "CreateTime", CStr(Now()))
'查询某个字符串值项的值
Rc = myRegAccess.QueryKeyValueSZ("HKEY_LOCAL_MACHINE", "SOFTWARE\MailerDeeSystem\KKmail", "CreateTime")
'删除某个字符串值项
Rc = myRegAccess.DeleteValueName("HKEY_LOCAL_MACHINE", "SOFTWARE\MailerDeeSystem\KKmail", "CreateTime")
'删除一个子项
Rc = myRegAccess.DeleteKey("HKEY_LOCAL_MACHINE", "SOFTWARE\MailerDeeSystem\KKmail", "1.0")
Set myRegAccess = Nothing
|
参阅 |
SMTPClient 对象 | POP3Client 对象 | CoreEncoder 对象 | TaskTimer 对象 | Registration 对象 |
|
|