OLA 文档中心

主题

2026-08-20

设置单个文件最大大小 - LogSetMaxFileSize ​

函数简介 ​

设置单个日志文件的最大大小，超过此大小时会自动创建新文件。

接口名称 ​

LogSetMaxFileSize

DLL调用 ​

c
int32_t LogSetMaxFileSize(int64_t instance, int64_t loggerHandle, int32_t maxFileSizeMb);

参数说明 ​

参数名类型说明
instance长整数型OLAPlug对象的指针，由 CreateCOLAPlugInterFace 接口生成。
loggerHandle长整数型日志实例句柄（0 表示默认实例）。
maxFileSizeMb整数型单个日志文件最大大小（MB）。

示例 ​

设 50MB，并启用 Rotation SIZE，超限自动滚到下一 {index} 文件。

SDK 调用 ​

cpp
#include "OLAPlugServer.h"

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

ola.LogSetBaseDirectory(logger, "D:\\logs");
ola.LogSetFileNamePattern(logger, "app_{date}_{index}.log");
ola.LogSetRotationMode(logger, 1); // SIZE
int ret = ola.LogSetMaxFileSize(logger, 50); // 50 MB
if (ret != 1) {
    return;
}
ola.LogInfo("max file size 50MB");
csharp
using System;
using OLAPlug;

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

ola.LogSetBaseDirectory(logger, @"D:\logs");
ola.LogSetFileNamePattern(logger, "app_{date}_{index}.log");
ola.LogSetRotationMode(logger, 1); // SIZE
int ret = ola.LogSetMaxFileSize(logger, 50); // 50 MB
if (ret != 1) return;
ola.LogInfo("max file size 50MB");
python
from OLAPlugServer import OLAPlugServer

ola = OLAPlugServer()
logger = 0

ola.LogSetBaseDirectory(logger, r"D:\logs")
ola.LogSetFileNamePattern(logger, "app_{date}_{index}.log")
ola.LogSetRotationMode(logger, 1)  # SIZE
ret = ola.LogSetMaxFileSize(logger, 50)  # 50 MB
if ret != 1:
    raise RuntimeError("failed")
ola.LogInfo("max file size 50MB")
java
import com.olaplug.OLAPlugServer;

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

ola.LogSetBaseDirectory(logger, "D:\\logs");
ola.LogSetFileNamePattern(logger, "app_{date}_{index}.log");
ola.LogSetRotationMode(logger, 1); // SIZE
int ret = ola.LogSetMaxFileSize(logger, 50); // 50 MB
if (ret != 1) {
    return;
}
ola.LogInfo("max file size 50MB");
go
import "github.com/ola/olaplug/olaplug"

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

ola.LogSetBaseDirectory(logger, `D:\logs`)
ola.LogSetFileNamePattern(logger, "app_{date}_{index}.log")
ola.LogSetRotationMode(logger, 1) // SIZE
ret := ola.LogSetMaxFileSize(logger, 50) // 50 MB
if ret != 1 {
    return
}
ola.LogInfo("max file size 50MB")
rust
use olaplug::OLAPlugServer;

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

ola.log_set_base_directory(logger, r"D:\logs");
ola.log_set_file_name_pattern(logger, "app_{date}_{index}.log");
ola.log_set_rotation_mode(logger, 1); // SIZE
let ret = ola.log_set_max_file_size(logger, 50); // 50 MB
if ret != 1 {
    return;
}
ola.log_info("max file size 50MB");
cpp
var ola = com("OlaPlug.OlaSoft")
var logger = 0

ola.LogSetBaseDirectory(logger, "D:\\logs")
ola.LogSetFileNamePattern(logger, "app_{date}_{index}.log")
ola.LogSetRotationMode(logger, 1) // SIZE
var ret = ola.LogSetMaxFileSize(logger, 50) // 50 MB
if(ret == 1) {
    ola.LogInfo("max file size 50MB")
}
vbscript
Set ola = CreateObject("OlaPlug.OlaSoft")
logger = 0

ola.LogSetBaseDirectory logger, "D:\logs"
ola.LogSetFileNamePattern logger, "app_{date}_{index}.log"
ola.LogSetRotationMode logger, 1
ret = ola.LogSetMaxFileSize(logger, 50)
If ret = 1 Then
    ola.LogInfo "max file size 50MB"
End If
text
.局部变量 ola, OLAPlug
.局部变量 ret, 整数型
.局部变量 logger, 长整数型

ola.Create ()
logger ＝ 0

ola.LogSetBaseDirectory (logger, “D:\logs”)
ola.LogSetFileNamePattern (logger, “app_{date}_{index}.log”)
ola.LogSetRotationMode (logger, 1)  ' SIZE
ret ＝ ola.LogSetMaxFileSize (logger, 50)  ' 50 MB
.如果真 (ret ＝ 1)
    ola.LogInfo (“max file size 50MB”)
.如果真结束
aardio
import OLAPlugServer;
var ola = OLAPlugServer();
var logger = 0;

ola.LogSetBaseDirectory(logger, "D:\\logs");
ola.LogSetFileNamePattern(logger, "app_{date}_{index}.log");
ola.LogSetRotationMode(logger, 1); // SIZE
var ret = ola.LogSetMaxFileSize(logger, 50); // 50 MB
if(ret == 1){
    ola.LogInfo("max file size 50MB");
}
text
变量 ola <类型 = OLAPlugServer>
ola = 新建 OLAPlugServer
长整数 logger = 0

ola.LogSetBaseDirectory(logger, "D:\\logs")
ola.LogSetFileNamePattern(logger, "app_{date}_{index}.log")
ola.LogSetRotationMode(logger, 1)  ' SIZE
整数 ret = ola.LogSetMaxFileSize(logger, 50)  ' 50 MB
如果真 (ret ＝ 1)
{
    ola.LogInfo("max file size 50MB")
}
cpp
#include "OLAPlugServer.h"

OLAPlugServer ola;
int64_t logger = 0;

ola.LogSetBaseDirectory(logger, "D:\\logs");
ola.LogSetFileNamePattern(logger, "app_{date}_{index}.log");
ola.LogSetRotationMode(logger, 1); // SIZE
int32_t ret = ola.LogSetMaxFileSize(logger, 50); // 50 MB
if (ret != 1) {
    return;
}
ola.LogInfo("max file size 50MB");

原生 DLL 调用 ​

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

LogSetBaseDirectory(instance, logger, "D:\\logs");
LogSetFileNamePattern(instance, logger, "app_{date}_{index}.log");
LogSetRotationMode(instance, logger, 1); // SIZE
int ret = LogSetMaxFileSize(instance, logger, 50); // 50 MB
if (ret != 1) {
    return;
}
LogInfo(instance, "max file size 50MB");
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 LogSetFileNamePattern(long ola, long loggerHandle, string fileNamePattern);
[DllImport("OLAPlug_x64.dll", CallingConvention = CallingConvention.StdCall)]
static extern int LogSetRotationMode(long ola, long loggerHandle, int rotationMode);
[DllImport("OLAPlug_x64.dll", CallingConvention = CallingConvention.StdCall)]
static extern int LogSetMaxFileSize(long ola, long loggerHandle, int maxFileSizeMb);
[DllImport("OLAPlug_x64.dll", CallingConvention = CallingConvention.StdCall)]
static extern int LogInfo(long ola, string message);

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

LogSetBaseDirectory(instance, logger, @"D:\logs");
LogSetFileNamePattern(instance, logger, "app_{date}_{index}.log");
LogSetRotationMode(instance, logger, 1);
int ret = LogSetMaxFileSize(instance, logger, 50);
if (ret != 1) return;
LogInfo(instance, "max file size 50MB");
python
from ctypes import CDLL, c_int, c_int64

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

ola.LogSetBaseDirectory(instance, logger, b"D:\\logs")
ola.LogSetFileNamePattern(instance, logger, b"app_{date}_{index}.log")
ola.LogSetRotationMode(instance, logger, 1)
ret = ola.LogSetMaxFileSize(instance, logger, 50)
if ret != 1:
    raise RuntimeError("LogSetMaxFileSize failed")
ola.LogInfo(instance, b"max file size 50MB")

返回值 ​

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

注意事项 ​

项目说明
默认值100MB。
当日志文件达到此大小时当日志文件达到此大小时，会自动创建新文件（滚动日志）。
修改后立即生效修改后立即生效，如果日志系统已初始化，会自动重新初始化。
配合使用需要配合 LogSetRotationMode 的 OLA_LOG_ROTATION_SIZE 模式使用。
建议根据磁盘空间和日志量合理设置建议根据磁盘空间和日志量合理设置。