销毁日志实例 - LogDestroyInstance
函数简介
销毁日志实例并释放资源。
接口名称
LogDestroyInstance
DLL调用
int32_t LogDestroyInstance(int64_t instance, int64_t loggerHandle)
参数说明
| 参数名 | 类型 | 说明 |
|---|---|---|
| instance | int64_t | OLAPlug对象的指针，由 CreateCOLAPlugInterFace 接口生成 |
| loggerHandle | int64_t | 要销毁的日志实例句柄 |
示例
// 创建并使用日志实例
int64_t networkLogger = LogCreateInstance(instance, "NetworkLogger");
LogSetModuleName(instance, networkLogger, "network");
LogInfoEx(instance, networkLogger, "网络日志");
// 使用完毕后销毁
int result = LogDestroyInstance(instance, networkLogger);
// 程序退出前销毁所有实例
LogDestroyInstance(instance, networkLogger);
LogDestroyInstance(instance, dbLogger);
LogDestroyInstance(instance, uiLogger);
// 注意：不能销毁默认实例（句柄 = 0）
// 错误示例：尝试销毁默认实例
int result = LogDestroyInstance(instance, 0); // 返回 0（失败）
返回值
| 返回值 | 说明 |
|---|---|
| 0 | 失败（实例不存在或为默认实例） |
| 1 | 成功 |
注意事项
- 不能销毁默认实例（句柄 = 0）
- 销毁后，该句柄将失效，不可再使用
- 销毁前会自动刷新所有缓冲区中的日志
- 销毁后会释放所有相关资源（文件句柄、内存等）
- 建议在程序退出前销毁所有自定义实例