OLA 文档中心

主题

2026-08-20

设置日志根目录 - LogSetBaseDirectory ​

函数简介 ​

设置日志系统的根目录路径，所有日志文件将保存在此目录下。

接口名称 ​

LogSetBaseDirectory

DLL调用 ​

c
int32_t LogSetBaseDirectory(int64_t instance, int64_t loggerHandle, const char* baseDirectory);

参数说明 ​

参数名类型说明
instance长整数型OLAPlug对象的指针，由 CreateCOLAPlugInterFace 接口生成。
loggerHandle长整数型日志实例句柄（0 表示默认实例）。
baseDirectory字符串根目录路径。

示例 ​

推荐联动：LogSetBaseDirectory → LogSetModuleName → LogSetFileNamePattern → 写日志 → LogGetCurrentFilePath。

SDK 调用 ​

cpp
#include "OLAPlugServer.h"
#include <cstdio>

OLAPlugServer ola;
const int64_t logger = 0; // 默认实例

int ret = ola.LogSetBaseDirectory(logger, "D:\\logs");
if (ret != 1) {
    return;
}
ola.LogSetModuleName(logger, "network");
ola.LogSetFileNamePattern(logger, "{module}_{date}_{index}.log");
ola.LogInfo("base directory ready");
std::string path = ola.LogGetCurrentFilePath(logger);
std::printf("current log file: %s\n", path.c_str());
csharp
using System;
using OLAPlug;

var ola = new OLAPlugServer();
long logger = 0;

int ret = ola.LogSetBaseDirectory(logger, @"D:\logs");
if (ret != 1) return;
ola.LogSetModuleName(logger, "network");
ola.LogSetFileNamePattern(logger, "{module}_{date}_{index}.log");
ola.LogInfo("base directory ready");
string path = ola.LogGetCurrentFilePath(logger);
Console.WriteLine("current log file: " + path);
python
from OLAPlugServer import OLAPlugServer

ola = OLAPlugServer()
logger = 0

ret = ola.LogSetBaseDirectory(logger, r"D:\logs")
if ret != 1:
    raise RuntimeError("failed")
ola.LogSetModuleName(logger, "network")
ola.LogSetFileNamePattern(logger, "{module}_{date}_{index}.log")
ola.LogInfo("base directory ready")
path = ola.LogGetCurrentFilePath(logger)
print("current log file:", path)
java
import com.olaplug.OLAPlugServer;

OLAPlugServer ola = new OLAPlugServer();
long logger = 0;

int ret = ola.LogSetBaseDirectory(logger, "D:\\logs");
if (ret != 1) {
    return;
}
ola.LogSetModuleName(logger, "network");
ola.LogSetFileNamePattern(logger, "{module}_{date}_{index}.log");
ola.LogInfo("base directory ready");
String path = ola.LogGetCurrentFilePath(logger);
System.out.println("current log file: " + path);
go
import (
    "fmt"
    "github.com/ola/olaplug/olaplug"
)

ola, _ := olaplug.NewOLAPlugServer("OLAPlug_x64.dll")
defer ola.ReleaseObj()
logger := int64(0)

ret := ola.LogSetBaseDirectory(logger, `D:\logs`)
if ret != 1 {
    return
}
ola.LogSetModuleName(logger, "network")
ola.LogSetFileNamePattern(logger, "{module}_{date}_{index}.log")
ola.LogInfo("base directory ready")
path := ola.LogGetCurrentFilePath(logger)
fmt.Println("current log file:", path)
rust
use olaplug::OLAPlugServer;

let ola = OLAPlugServer::new("OLAPlug_x64.dll").unwrap();
let logger = 0i64;

let ret = ola.log_set_base_directory(logger, r"D:\logs");
if ret != 1 {
    return;
}
ola.log_set_module_name(logger, "network");
ola.log_set_file_name_pattern(logger, "{module}_{date}_{index}.log");
ola.log_info("base directory ready");
let path = ola.log_get_current_file_path(logger);
println!("current log file: {}", path);
cpp
var ola = com("OlaPlug.OlaSoft")
var logger = 0

var ret = ola.LogSetBaseDirectory(logger, "D:\\logs")
if(ret == 1) {
    ola.LogSetModuleName(logger, "network")
    ola.LogSetFileNamePattern(logger, "{module}_{date}_{index}.log")
    ola.LogInfo("base directory ready")
    var path = ola.LogGetCurrentFilePath(logger)
    traceprint("current log file: " + path)
}
vbscript
Set ola = CreateObject("OlaPlug.OlaSoft")
logger = 0

ret = ola.LogSetBaseDirectory(logger, "D:\logs")
If ret = 1 Then
    ola.LogSetModuleName logger, "network"
    ola.LogSetFileNamePattern logger, "{module}_{date}_{index}.log"
    ola.LogInfo "base directory ready"
    path = ola.LogGetCurrentFilePath(logger)
    TracePrint "current log file: " & path
End If
text
.局部变量 ola, OLAPlug
.局部变量 ret, 整数型
.局部变量 logger, 长整数型
.局部变量 path, 文本型

ola.Create ()
logger ＝ 0

ret ＝ ola.LogSetBaseDirectory (logger, “D:\logs”)
.如果真 (ret ＝ 1)
    ola.LogSetModuleName (logger, “network”)
    ola.LogSetFileNamePattern (logger, “{module}_{date}_{index}.log”)
    ola.LogInfo (“base directory ready”)
    path ＝ ola.LogGetCurrentFilePath (logger)
    调试输出 (“current log file：”, path)
.如果真结束
aardio
import OLAPlugServer;
var ola = OLAPlugServer();
var logger = 0;

var ret = ola.LogSetBaseDirectory(logger, "D:\\logs");
if(ret == 1){
    ola.LogSetModuleName(logger, "network");
    ola.LogSetFileNamePattern(logger, "{module}_{date}_{index}.log");
    ola.LogInfo("base directory ready");
    var path = ola.LogGetCurrentFilePath(logger);
    io.print("current log file: ", path);
}
text
变量 ola <类型 = OLAPlugServer>
ola = 新建 OLAPlugServer
长整数 logger = 0

整数 ret = ola.LogSetBaseDirectory(logger, "D:\\logs")
如果真 (ret ＝ 1)
{
    ola.LogSetModuleName(logger, "network")
    ola.LogSetFileNamePattern(logger, "{module}_{date}_{index}.log")
    ola.LogInfo("base directory ready")
    文本 path = ola.LogGetCurrentFilePath(logger)
    调试输出 ("current log file：", path)
}
cpp
#include "OLAPlugServer.h"
#include <cstdio>

OLAPlugServer ola;
int64_t logger = 0;

int32_t ret = ola.LogSetBaseDirectory(logger, "D:\\logs");
if (ret != 1) {
    return;
}
ola.LogSetModuleName(logger, "network");
ola.LogSetFileNamePattern(logger, "{module}_{date}_{index}.log");
ola.LogInfo("base directory ready");
std::string path = ola.LogGetCurrentFilePath(logger);
std::printf("current log file: %s\n", path.c_str());

原生 DLL 调用 ​

cpp
long instance = CreateCOLAPlugInterFace();
long logger = 0;

int ret = LogSetBaseDirectory(instance, logger, "D:\\logs");
if (ret != 1) {
    return;
}
LogSetModuleName(instance, logger, "network");
LogSetFileNamePattern(instance, logger, "{module}_{date}_{index}.log");
LogInfo(instance, "base directory ready");
// LogGetCurrentFilePath → 如 D:\logs\network_2026-03-02_1.log
csharp
using System.Runtime.InteropServices;

[DllImport("OLAPlug_x64.dll", CallingConvention = CallingConvention.StdCall)]
static extern long CreateCOLAPlugInterFace();
[DllImport("OLAPlug_x64.dll", CallingConvention = CallingConvention.StdCall)]
static extern int LogSetBaseDirectory(long ola, long loggerHandle, string baseDirectory);
[DllImport("OLAPlug_x64.dll", CallingConvention = CallingConvention.StdCall)]
static extern int LogSetModuleName(long ola, long loggerHandle, string moduleName);
[DllImport("OLAPlug_x64.dll", CallingConvention = CallingConvention.StdCall)]
static extern int LogSetFileNamePattern(long ola, long loggerHandle, string fileNamePattern);
[DllImport("OLAPlug_x64.dll", CallingConvention = CallingConvention.StdCall)]
static extern int LogInfo(long ola, string message);

long instance = CreateCOLAPlugInterFace();
long logger = 0;

int ret = LogSetBaseDirectory(instance, logger, @"D:\logs");
if (ret != 1) return;
LogSetModuleName(instance, logger, "network");
LogSetFileNamePattern(instance, logger, "{module}_{date}_{index}.log");
LogInfo(instance, "base directory ready");
python
from ctypes import CDLL, c_int, c_int64

ola = CDLL("OLAPlug_x64.dll")
ola.CreateCOLAPlugInterFace.restype = c_int64
instance = ola.CreateCOLAPlugInterFace()
logger = 0

ret = ola.LogSetBaseDirectory(instance, logger, b"D:\\logs")
if ret != 1:
    raise RuntimeError("LogSetBaseDirectory failed")
ola.LogSetModuleName(instance, logger, b"network")
ola.LogSetFileNamePattern(instance, logger, b"{module}_{date}_{index}.log")
ola.LogInfo(instance, b"base directory ready")

返回值 ​

返回值说明
1成功。
0失败。

注意事项 ​

项目说明
默认值./user_logs（程序运行目录下）。
路径支持相对路径和绝对路径。
修改后立即生效修改后立即生效，如果日志系统已初始化，会自动重新初始化。
如果目录不存在如果目录不存在，系统会自动创建。
配合 LogSetDirMode 可以实现更配合 LogSetDirMode 可以实现更复杂的目录组织结构。