设置环境变量 - RegistrySetEnvironmentVariable

函数简介

设置环境变量，支持用户级和系统级环境变量。

接口名称

RegistrySetEnvironmentVariable

DLL调用

int32_t RegistrySetEnvironmentVariable(int64_t instance, const char* name, const char* value, int32_t systemWide);

参数说明

参数名	类型	说明
instance	长整数型	OLAPlug对象的指针，由 CreateCOLAPlugInterFace 接口生成。
name	字符串	环境变量名称
value	字符串	环境变量值
systemWide	整数型	是否为系统级环境变量。1 系统级（所有用户可见），0 当前用户级

示例

int64_t instance = CreateCOLAPlugInterFace();

// 设置用户级环境变量
RegistrySetEnvironmentVariable(instance, "OLA_HOME", "C:\\OLAPlug", 0);

// 设置系统级环境变量（需要管理员权限）
RegistrySetEnvironmentVariable(instance, "OLA_SYSTEM_CONFIG", "C:\\Program Files\\OLAPlug\\config", 1);

DestroyCOLAPlugInterFace(instance);

返回值

整数型。1 成功，0 失败。

注意事项

• 设置系统级环境变量（systemWide=1）需要管理员权限。
• 环境变量设置后可能需要重新启动应用程序或系统才能生效。
• 修改PATH等系统变量时建议先读取现有值，再追加新值。
• 环境变量名称不区分大小写。
• 系统级环境变量存储在 HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Session Manager\Environment。
• 用户级环境变量存储在 HKEY_CURRENT_USER\Environment。