设置模块名称 - LogSetModuleName
函数简介
设置日志实例的模块名称，用于目录组织和文件命名。
接口名称
LogSetModuleName
DLL调用
int32_t LogSetModuleName(int64_t instance, int64_t loggerHandle, const char* moduleName)
参数说明
| 参数名 | 类型 | 说明 |
|---|---|---|
| instance | int64_t | OLAPlug对象的指针，由 CreateCOLAPlugInterFace 接口生成 |
| loggerHandle | int64_t | 日志实例句柄（0 表示默认实例） |
| moduleName | string | 模块名称（用于目录组织） |
示例
// 设置模块名称为 "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
// 多实例场景
int64_t networkLogger = LogCreateInstance(instance, "NetworkLogger");
LogSetModuleName(instance, networkLogger, "network");
int64_t databaseLogger = LogCreateInstance(instance, "DatabaseLogger");
LogSetModuleName(instance, databaseLogger, "database");
返回值
| 返回值 | 说明 |
|---|---|
| 0 | 失败 |
| 1 | 成功 |
注意事项
- 用于
OLA_LOG_DIR_BY_MODULE目录模式 - 可在文件名模式中使用
{module}占位符 - 修改后立即生效，如果日志系统已初始化，会自动重新初始化
- 建议使用英文字母、数字和下划线，避免特殊字符
- 不同的日志实例可以设置不同的模块名称，实现日志分类管理