设置模块名称 - LogSetModuleName

函数简介

设置日志实例的模块名称，用于目录组织和文件命名。

接口名称

LogSetModuleName

DLL调用

int32_t LogSetModuleName(int64_t instance, int64_t loggerHandle, const char* moduleName);

参数说明

参数名	类型	说明
instance	长整数型	OLAPlug对象的指针，由 CreateCOLAPlugInterFace 接口生成。
loggerHandle	长整数型	日志实例句柄（0 表示默认实例）
moduleName	字符串	模块名称（用于目录组织）

示例

// 设置模块名称为 "network"
int result = LogSetModuleName(instance, 0, "network");

// 配合目录模式使用
LogSetDirMode(instance, 0, OLA_LOG_DIR_BY_MODULE);
// 结果：./user_logs/network/app.log

// 配合文件名模式使用
LogSetFileNamePattern(instance, 0, "{module}_{date}.log");
// 结果：network_2026-03-02.log

返回值

1 成功，0 失败。

注意事项

• 用于 OLA_LOG_DIR_BY_MODULE 目录模式
• 可在文件名模式中使用 {module} 占位符
• 修改后立即生效，如果日志系统已初始化，会自动重新初始化
• 建议使用英文字母、数字和下划线，避免特殊字符
• 不同的日志实例可以设置不同的模块名称，实现日志分类管理