创建指定的注册表键.
#Include <WinAPIEx.au3>
_WinAPI_RegCreateKey ( $hKey [, $sSubKey [, $iAccess [, $iOptions [, $tSecurity]]]] )
$hKey | 已打开的注册表项句柄.如果该键已经存在,函数将打开它.调用进程必须有 $KEY_CREATE_SUB_KEY 访问权. 句柄由 _WinAPI_RegCreateKey() 或 _WinAPI_RegOpenKey() 函数返回,也可以是下列预定义键码之一: 也可以是下列预定义键码之一: $HKEY_CLASSES_ROOT --- 定义文件类型和类型相关的属性 $HKEY_CURRENT_CONFIG --- 包含本地计算机系统目前的硬件配置文件 $HKEY_CURRENT_USER --- 定义当前用户的参数选择 $HKEY_LOCAL_MACHINE --- 定义计算机物理状态,包括总线类型、系统内存数据、并安装的硬件和软件 $HKEY_USERS --- 确定本地计算机新用户定义默认用户配置,并作为当前用户的用户配置 |
$sSubKey | [可选参数] 函数打开或创建的子项名称. 子项必须是由 $hKey 参数确定的键子项,可达到 32 级注册表树深. |
$iAccess | [可选参数] 指定键的访问权限掩码.参数可以是一或多个 $KEY_ALL_ACCESS --- 综合STANDARD_RIGHTS_REQUIRED、KEY_QUERY_VALUE、KEY_SET_VALUE、KEY_CREATE_SUB_KEY、KEY_ENUMERATE_SUB_KEYS、KEY_NOTIFY 与 KEY_CREATE_LINK 访问权限 $KEY_CREATE_LINK --- 保留给系统使用 $KEY_CREATE_SUB_KEY --- 必须创建注册表项的子项 $KEY_ENUMERATE_SUB_KEYS --- 必须枚举注册表项的子项 $KEY_EXECUTE --- 相当于 KEY_READ $KEY_NOTIFY --- 必须要求注册表项或注册表项子项的更改通知 $KEY_QUERY_VALUE --- 需要查询注册表项的值 $KEY_READ --- 综合 STANDARD_RIGHTS_READ、KEY_QUERY_VALUE、KEY_ENUMERATE_SUB_KEYS、KEY_NOTIFY $KEY_SET_VALUE --- 需要创建、删除、或设置一个注册表值 $KEY_WOW64_32KEY --- 64 位 Windows 应用程序应该运行 32 位注册表视图 $KEY_WOW64_64KEY --- 64 位 Windows 应用程序运行 64 位注册表视图 $KEY_WRITE --- 综合STANDARD_RIGHTS_WRITE、KEY_SET_VALUE、KEY_CREATE_SUB_KEY 访问权限 |
$iOptions | [可选参数] 参数可以是以下值之一: $REG_OPTION_BACKUP_RESTORE --- 忽略 $iDesired 参数 $REG_OPTION_CREATE_LINK --- 键是一个符号链接 $REG_OPTION_NON_VOLATILE --- 当系统重新启动时信息存储到文件,并保存 $REG_OPTION_VOLATILE --- 函数创建的所有键不稳定 |
$tSecurity | [可选参数] $tagSECURITY_ATTRIBUTES 结构,决定返回的句柄是否可以通过子进程继承. 如果此参数为 0, 句柄不能被继承. |
成功: | 返回打开或创建的键项句柄,@extended 标志将包含下列配置值之一: |
0 (FALSE) - 键项存在并简单地打开且没有被改变. | |
1 (TRUE) - 键不存在但已建立. | |
失败: | 返回 0,设置 @error 标志为非 0 值, @extended 标志可能包含系统错误代码. |
在MSDN中搜索