创建日志实例 - LogCreateInstance
函数简介
创建新的日志实例,用于实现多实例日志管理。
接口名称
LogCreateInstance
DLL调用
int64_t LogCreateInstance(int64_t instance, const char* instanceName);
参数说明
| 参数名 | 类型 | 说明 |
|---|---|---|
| instance | 长整数型 | OLAPlug对象的指针,由 CreateCOLAPlugInterFace 接口生成。 |
| instanceName | 字符串 | 实例名称(用于标识,如 "NetworkLogger") |
示例
// 创建网络日志实例
int64_t networkLogger = LogCreateInstance(instance, "NetworkLogger");
if (networkLogger != 0) {
LogSetModuleName(instance, networkLogger, "network");
LogSetFilePath(instance, networkLogger, "./logs/network.log");
LogInfoEx(instance, networkLogger, "网络日志初始化成功");
}
返回值
日志实例句柄(长整数型),失败返回 0。
注意事项
- 新创建的实例使用默认配置
- 实例句柄必须通过
LogDestroyInstance释放 - 默认实例(句柄 = 0)无需创建,始终存在
- 每个实例可以有独立的配置(路径、级别、格式等)
- 适合需要分类管理日志的场景(按模块、按功能等)
