Inno Setup 注册表启动项 修改注册表

来源:互联网 发布:识别歌曲的软件 编辑:程序博客网 时间:2024/05/09 11:48

//注册表启动项 
[Registry] 
Root: HKLM; Subkey: "SOFTWARE\Microsoft\Windows\CurrentVersion\Run"; ValueType: string; ValueName: "testrun"; ValueData: "{app}\{#MyAppExeName}" 



这个可选段用来定义一些你想用安装程序在用户系统中创建、修改或删除的注册表键/值。 

按默认,用安装程序创建的注册表键和值在卸载时不删除。如果你想让卸载程序删除键或值,你必须包含下面 uninsdelete* 标记中的一个。 

下面是 [Registry] 段的一个示例: 

[Registry] Root: HKCU; Subkey: "Software\My Company"; Flags: uninsdeletekeyifempty Root: HKCU; Subkey: "Software\My Company\My Program"; Flags: uninsdeletekey Root: HKLM; Subkey: "Software\My Company"; Flags: uninsdeletekeyifempty Root: HKLM; Subkey: "Software\My Company\My Program"; Flags: uninsdeletekey Root: HKLM; Subkey: "Software\My Company\My Program\Settings"; ValueType: string; ValueName: "InstallPath"; ValueData: "{app}" 
下列是所支持的参数列表: 

Root  (必需的) 
根键。必须是下列值中的一个: 

HKCR (HKEY_CLASSES_ROOT) 
HKCU (HKEY_CURRENT_USER) 
HKLM (HKEY_LOCAL_MACHINE) 
HKU (HKEY_USERS) 
HKCC (HKEY_CURRENT_CONFIG) 

该值可以带有 32 或 64 的后缀。带 32 后缀的根键值 (例如 HKLM32) 映射到 32 位系统注册表,带 64 后缀的根键值 (例如 HKLM64) 映射到 64 位系统注册表。 

带 64 后缀的根键值只能在安装程序在 64 位 Windows 运行时使用,否则将会出错。在支持 32 和 64 位结构的安装程序中,这可以通过添加 Check: IsWin64 参数检查来避免,这会在运行于 32 位 Windows 时该条目自动跳过。

不带后缀的根键值 (例如 HKLM) 等于带后缀 32 的值 (例如 HKLM32),除非安装程序运行于 64 位模式,在这种情况下,该值等于带后缀 64 的值 (例如 HKLM64)。 

示例:Root: HKCUSubkey  (必需的) 
子键名,可以包含常量。 

示例:Subkey: "Software\My Company\My Program"ValueType 
值的数据类型。必须是下面中的一个: 

none 
string 
expandsz 
multisz 
dword 
qword 
binary 

如果指定了 none (默认设置),安装程序将创建一个没有键值的键,在这种情况下,ValueName 和 ValueData 参数将被忽略。 
如果指定了 string,安装程序将创建一个字符串 (REG_SZ) 值。 
如果指定了 expandsz,安装程序将创建一个扩展字符串 (REG_EXPAND_SZ) 值。 
如果指定了 multisz,安装程序将创建一个多行文本 (REG_MULTI_SZ) 值。 
如果指定了 dword,安装程序将创建一个32位整数 (REG_DWORD) 值。 
如果指定了 qdword,安装程序将创建一个64位整数 (REG_QDWORD) 值。 
如果指定了 binary,安装程序将创建一个二进制 (REG_BINARY) 值。 

示例:ValueType: stringValueName 
要创建的值名,可以包含常量。如果是空白的,将写入到“默认”值。如果 ValueType 参数设置为 none,这个参数被忽略。 

示例:ValueName: "Version"ValueData 
值的数据。如果 ValueType 参数是 string,expandsz 或 multisz,这是这一个可以包含常量的字符串。如果数据类型是 dword或qdword,这可以是一个十进制整数 (例如“123”),一个十六进制整数 (例如“$7B”) 或解析为整数的常量。如果数据类型是 binary,这可以是下列形式的十六进制字节序列: “00 ff 12 34”。如果数据类型是 none,将被忽略。 

在 string,expandsz 或 multisz 类型值中,你可以在这个参数中使用一个特殊的常量调用 {olddata}。{olddata} 用先前的注册表值数据替换。如果你想添加一个字串到现有的值中,{olddata} 常量非常有用。例如,{olddata};{app}。如果该值不存在或现有的值不是一个字符串类型,{olddata} 常量将被删除。如果创建的值是一个 multisz 类型,但现有的值不是多行字符类型(例如,它是 REG_SZ 或 REG_EXPAND_SZ),{olddata} 常量也将被删除。反这亦然。 

在 multisz 类型值中,你可以在参数中使用一个特殊常量调用 {break} 以插入换行符。 

示例:ValueData: "1.0"Permissions 
指定登录注册表键 ACL (访问控制列表) 的附加权限。如果你不熟悉 ACL 或你不知道为什么要列改,不推荐你使用这个参数,因为误用会导致重大的系统安全问题。 

这个参数在用户必须运行 Windows 2000 或更高版本 (NT 4.0 由于 API 的问题不支持) 以及当前用户必须有更改注册表的权限时才有效。这些条件不满足时,不会显示错误消息,权限也不会被设置。 

这个参数应该只使用于你的应用程序特有的注册表键中。不要更改顶级键象 HKEY_LOCAL_MACHINE\SOFTWARE 的 ACL,否则你自己打开了用户系统的安全漏洞。 

指定的权限不考虑注册表键在安装前是否存在。如果 ValueType 是 none 和使用了 deletekey 或 deletevalue 标记时,不要设置这个权限。 

这个参数可以包含象下列格式一样一个或多个空格分隔的值: 

<用户或组标识>-<访问类型> 

下面是 [Registry] 段支持的访问类型: 

full 
同意“完全控制”许可,与 modify 相同 (看下面),但又加上允许指定的用户/用户组获取注册表键所有权,并改变它的许可。通常保守的使用 modify 就足够了。 

modify 
同意“修改”许可,允许指定的用户/用户组读取、修改和删除注册表值或子键。 

read 
同意“读取和执行”许可,允许指定的用户/用户组读取注册表值或子键。 

示例:Permissions: users-modifyFlags 
这个参数是额外选项设置。多个选项可以使用空格隔开。支持下面的选项: 

createvalueifdoesntexist 
当指定了这个标记,安装程序只在如果没有相同名字的值存在时创建值。如果值类型是 none,或如果你指定了 deletevalue 标记,这个标记无效。 

deletekey 
当指定了这个标记,安装程序在如果条目存在的情况下,先将尝试删除它,包括其中的所有值和子键。如果 ValueType 不是 none,那么它将创建一个新的键和值。 

要防止意外,如果 Subkey 是空白的或只包含反斜框符号,安装时这个标记被忽略。 

deletevalue 
当指定了这个标记,安装程序在如果值存在的情况下,先将尝试删除值,如果 ValueType 是 none,那么在键不存在的情况下,它将创建键以及新值。 

dontcreatekey 
当指定了这个标记,如果键已经在用户系统中不存在,安装程序将不尝试创建键或值。如果键不存在,不显示错误消息。 

一般来说,这个键与 uninsdeletekey 标记组合使用,在卸载时删除键,但安装时不创建键。 

noerror 
如果安装程序因任何原因创建键或值失败,不显示错误消息。 

preservestringtype 
这只在当 ValueType 参数是 string 或 expandsz 时适用。当指定这个标记,并且值不存在或现有的值不是 string 类型 (REG_SZ 或 REG_EXPAND_SZ),它将用 ValueType 指定的类型创建。如果值存在,并且是 string 类型,它将用先存在值的相同值类型替换。 

uninsclearvalue 
当卸载程序时,设置值数据为空字符 (类型 REG_SZ)。这个标记不能与 uninsdeletekey 标记组合使用。 

uninsdeletekey 
当卸载程序时,删除整个键,包含其中的所有值和子键。这对于 Windows 自身使用的键明显不是一个好方法。你只能用于你的应用程序特有的键中。 

为防止意外,安装期间如果 Subkey 空白或只包含反斜框符号,这个标记被忽略。 

uninsdeletekeyifempty 
当程序卸载时,如果这个键的内部没有值或子键,则删除这个键。这个标记可以与 uninsdeletevalue 组合使用 

为防止意外,安装期间如果 Subkey 空白或只包含反斜框符号,这个标记被忽略。 

uninsdeletevalue 
当程序卸载时删除该值。这个标记不能与 uninsdeletekeyifempty 组合使用 

注意: 在早于 1.1 的 Inno Setup 版本中,你可以使用这个标记连同数据类型 none,那么它的功能与“如果空则删除键”标记一样。这个方法已经不支持了。你必须使用 uninsdeletekeyifempty 标记实现。 

示例:Flags: uninsdeletevalue

1 0