马上注册,结交更多好友,享用更多功能,让你轻松玩转社区。
您需要 登录 才可以下载或查看,没有账号?站点注册
×
PBIDEA:用 uo_dll 动态调用外部 DLL 全解(LoadFunctionList、参数压栈、引用参数、回调与内存读写,PB10 基准 · PB12.5 实测)
阅读说明
1. 适用版本:基准 PB10,兼容 PB 12.5,两版均实机验证;本主题两版读数逐字一致,差异小节见第十三节
2. 支持数据库:本文示例不依赖数据库,全部调用走系统 DLL(kernel32.dll / user32.dll),连不连库都照常适用
3. 操作系统与环境要求:Windows 7+,PB 运行库(PBVM)正常安装;uo_dll 声明在 PBIDEA 的 websuite.pbl 中,运行需随版 PbIdea.dll
4. 难度系数:★★★★☆(涉及指针、编码与回调,建议先有外部函数声明使用经验)
5. 其它阅读说明:文中所有读数均来自本机实测,凡属「机制推断」而非直接证据的地方都已注明
【版本声明】
- 本文以 PBIDEA 当前最新版本为准(版本源由维护方统一核验),并对照随版发布的源码整理。
- 核验日期:2026-11-16;当次核验的 PBIDEA 核心运行库:18,318,336 字节 / 2611 个导出,md5 25ac290414ab…。
- 版本识别口径:逐项解析 PE 导出表(文件体积、目录名都不能作为判据)。
- PBIDEA 版本会持续更新,本文只对上述核验时点的最新版本负责;后续若行为有变,以新版为准。
一、这一篇讲什么
PB 调外部 DLL 有两条路。老路是编译期声明:function long lstrlenA(string s) library "kernel32.dll",写死在代码里,改一个函数要重新编译。新路就是本文主角 uo_dll:把「加载哪个 DLL 的哪个函数、压什么参数、怎么调」全部变成运行时动作,还顺手补齐了原生声明做不到的三件事——枚举一个 DLL 的全部导出函数、CDECL 调用约定、回调。
这个对象一共五十多个方法,但核心就一条主线:
- LoadFunction( dll, func, mode ) → PushArg( 参数1 ) → PushArg( 参数2 ) → Invoke( 返回值 )
复制代码
围绕这条主线,本文用 kernel32 和 user32 的真实函数把每个环节全部实机测清:字符串参数的三种编码形态、引用参数怎么拿到结果、回调怎么绑定到 PB 事件、内存怎么分配和回读,以及每一处「静默给错值不报错」的坑。所有结论 PB10 与 PB12.5 双轨各跑一遍,读数逐字一致。
二、API 全貌:六组方法
| 分组 | 方法 | 一句话职责 | | 枚举 | LoadFunctionList(两个重载) | 列出 DLL 的全部导出函数名(可选带地址) | | 调用主线 | LoadFunction / FreeFunction / PushArg(13 重载)/ PushRefArg / Invoke(6 重载) | 加载、压参数、调用 | | 回调 | CreateCallback / PushCallbackArg / PushCallbackArgType / BindCallbackEvent / stop | 把 PB 事件变成函数指针传给 DLL | | 内存 | AllocMemory / FreeMemory / ReadMemory / ReadString 四兄弟 / ReadInt / ReadLong / CopyMemory(4 重载) | 分配、回读、搬运 | | 取地址 | AddressOf(12 类型重载)/ SizeOf | 拿 PB 变量的内存地址、查大小 | | 工具 | Hex / HexToDec / DecToHex | 十六进制换算 |
调用约定常量:CDECL=1、STDCALL=2,LoadFunction 第三参传 1 或 2;字符串编码常量:ANSI=1、UNICODE=2。参数类型常量(INT_TYPE=1 到 LONGLONG_TYPE=20)是给回调声明参数类型用的。
三、最小可运行示例
放进任何按钮事件都能跑,调 kernel32 的 lstrlenA(求 ANSI 串字节长度):
- // 目的:加载 lstrlenA,压一个 ANSI 串,调用并取回长度
- uo_dll ld
- boolean lb
- long ll_len
- ld = create uo_dll
- lb = ld.LoadFunction('kernel32.dll', 'lstrlenA', 2) // 2 = STDCALL
- lb = ld.PushArg('abcd', 1) // 1 = 转 ANSI 字节
- lb = ld.Invoke(ll_len) // 返回 true,ll_len = 4
- ld.FreeFunction()
- destroy ld
- MessageBox('结果', 'lstrlenA(abcd) = ' + String(ll_len)) // 弹出 4
复制代码
三个布尔返回值都要接住:LoadFunction 加载失败返 false,PushArg 压栈失败返 false,Invoke 调用失败返 false。但要注意——返 false 只代表这一步没做成功,不会告诉你为什么,排查靠自查参数(见第十二节的失败形态清单)。
四、LoadFunctionList:枚举一个 DLL 的全部导出
- // 目的:枚举 kernel32.dll 的导出函数名
- uo_dll ld
- string ls_names[]
- long n
- ld = create uo_dll
- n = ld.LoadFunctionList('kernel32.dll', ls_names)
- destroy ld
- // 本机实测:n = 1610,UpperBound(ls_names) = 1610
复制代码
实测读数(PB10 与 PB12.5 一致):
| 用例 | 读数 | | LoadFunctionList('kernel32.dll', 数组) | 1610,数组上限 1610,含 GetTickCount | | 第二重载(多收一个地址数组) | 同样 1610,地址数组上限 1610,但地址元素是空串(本机) | | 'KERNEL32.DLL'(全大写) | 1610——大小写不敏感 | | 'no_such_dll_xyz.dll'(不存在的 DLL) | 返回 0,数组不膨胀,不报错、不崩溃 | | 数组首元素 | 空串(导出表 0 号序号位,正常现象) | | 数组末元素 | timeGetTime(kernel32 里确实有这个转发导出) |
这里有一个必须单独拎出来的坑:进程刚启动就立刻调 LoadFunctionList 枚举大 DLL,有概率直接崩 0xC0000005。我在验证时复现得很稳定:PBVM 测试进程一启动马上枚举 kernel32,连跑十次崩十次;但在调用前先做一次任意文件 IO(哪怕只是写一行日志),十次全过。机制上推断是导出表解析依赖某种惰性初始化,进程最早期还没就绪——这条只敢标注为「实测现象+推断」,但对策很实在:程序启动后先干点别的(初始化配置、写日志都行),再调 LoadFunctionList 枚举大 DLL;小 DLL 或运行中途调用未复现此问题。
五、字符串参数:charset 三态实测表
PushArg 的 string 重载有两个:不带 charset(默认 0)和显式传 0/1/2。用 lstrlenA(数 ANSI 字节)和 lstrlenW(数 Unicode 字符)当探针,ASCII 串与中文各来一遍,实测矩阵如下:
| 压栈写法 | lstrlenA 读数 | lstrlenW 读数 | | PushArg('abcd', 1) ANSI | 4(abcd 四字节) | — | | PushArg('abcd', 2) UNICODE | — | 4(四个 Unicode 字符) | | PushArg('abcd') 默认 | 1 | — | | PushArg('中文', 1) ANSI | 4(GBK 四字节) | — | | PushArg('中文', 2) UNICODE | — | 2(两个字符) | | PushArg('中文') 默认 | 4 | — |
逐条解释:
- charset=1 才是给 ANSI API 喂参数的正确姿势:PB 串转 ANSI 字节,lstrlenA 数到 4;
- charset=2 给宽字符 API:转 UTF-16LE,lstrlenW 数字符数;
- 默认 charset 的行为不一致,是本主题最阴的一处:'abcd' 时 lstrlenA 只读到 1(说明传进去的字节是 61 00 62 00 … 的 UTF-16LE 原始形态,A 后面就撞上 NUL),而 '中文' 时却读到 4(又变成 GBK 形态)。两个用例走的是同一个方法,结果形态却不同——实测只能确认「默认态对纯 ASCII 串与含中文串给出了两种字节布局」,机制推断是「检测到非 ASCII 才转码」;不管内部机制如何,结论只有一条:字符串参数永远显式传 charset,别用默认态。
中文串的构造在测试代码里有个附带提醒:源码里直接写中文字面量可能被编码转换环节悄悄弄乱,用 Char(20013) + Char(25991) 按码点构造最稳。
六、两个参数与返回值:lstrcmpA
多参数就是多次 PushArg,按从左到右的顺序压:
- // 目的:两参数调用,验证返回值回传
- ld.LoadFunction('kernel32.dll', 'lstrcmpA', 2)
- ld.PushArg('a', 1)
- ld.PushArg('b', 1)
- lb = ld.Invoke(ll_r) // ll_r = -1
- ld.FreeFunction()
复制代码
实测读数:lstrcmpA('a','b') = -1、lstrcmpA('ab','ab') = 0、lstrcmpA('','x') = -1;还有一个反直觉的:lstrcmpA('B','a') 本机实测返回 1。这几个读数原文照录,给需要用 lstrcmp 做精确比较的读者当基准。
七、引用参数:PushRefArg 全链(拿到「写回」的结果)
很多 API 的结果是写到你提供的缓冲区里的(LPSTR + 大小指针那一族)。uo_dll 的路数是:PushRefArg(字节数) 压进一个指定大小的缓冲区并返回它的内存地址,调用完用内存读取函数把结果捞回来。完整链路用 GetComputerNameA(取本机计算机名)验证:
- // 目的:引用参数全链——预填大小缓冲区,调用后回读字符串
- uo_dll ld
- uo_blob lbx
- ulong a_buf, a_len
- blob lb_fill
- long ilen, lok
- string ls_name
- boolean lb
- ld = create uo_dll
- lb = ld.LoadFunction('kernel32.dll', 'GetComputerNameA', 2) // 先加载函数
- a_buf = ld.PushRefArg(261) // 第一个引用参数:名字缓冲区(MAX_COMPUTERNAME_LENGTH+1)
- a_len = ld.PushRefArg(8) // 第二个引用参数:长度指针
- // 长度缓冲区必须预填「缓冲区大小」,否则 API 报缓存不足
- lbx = create uo_blob
- lbx.FromHex('04010000') // 260 的小端四字节
- lb_fill = lbx.ToBlob()
- ld.CopyMemory(a_len, lb_fill, 4)
- lb = ld.Invoke(lok) // lok = 1 表示成功
- ls_name = ld.ReadAnsiString(a_buf)
- ilen = ld.ReadInt(a_len) // API 写回的实际长度
- ld.FreeMemory(a_buf)
- ld.FreeMemory(a_len)
- ld.FreeFunction()
- destroy lbx
- destroy ld
- // 本机实测:lok=1,名字长度 = ilen = 15,两者相等
复制代码
三个实测要点:PushRefArg 必须在 LoadFunction 之后调(先压栈后加载会崩 0xC0000005,这是我在探针第一版真实踩到的);需要「输入型」引用参数(如上面的长度)时用 CopyMemory 把预填值写进 PushRefArg 返回的地址;回读用 ReadAnsiString / ReadInt 这族函数,编码要选对。
八、无窗口 API 照样能调:GetSystemMetrics
- // 目的:调 user32 取屏幕尺寸
- ld.LoadFunction('user32.dll', 'GetSystemMetrics', 2)
- ld.PushArg(0) // SM_CXSCREEN
- lb = ld.Invoke(li_cx) // 本机实测 1718
- ld.FreeFunction()
- ld.LoadFunction('user32.dll', 'GetSystemMetrics', 2)
- ld.PushArg(1) // SM_CYSCREEN,实测 926
- lb = ld.Invoke(li_cy)
- ld.FreeFunction()
复制代码
负索引实测:PushArg(-1) 后调用返回 0,不崩不报错。pbtest 这类无窗口运行环境跑这组用例完全正常——「uo_dll 只能在有窗口的程序里用」是讹传。
九、十六进制工具家族
| 用例 | 实测读数 | | Hex(65, 4) | '0041'(与声明注释一致,大写、补零到 4 位) | | Hex(255) | 'FF'(不带长度参数按需输出,仍是大写) | | Hex(0) | '0' | | DecToHex(255) | 'ff'——小写,与 Hex 的大小写方向相反 | | DecToHex(0) | '0' | | DecToHex(longlong -1) | 'ffffffffffffffff'(64 位全 1,负数按补码展开) | | HexToDec('0041') | 65 | | HexToDec('FF') / HexToDec('ff') | 255 / 255(大小写都认) | | HexToDec('0x41') | 65——带 0x 前缀也能解析 | | HexToDec('') | 0,静默 | | HexToDec('xyz') | 0,静默——非法输入一律静默返 0,不报错 | | DecToHex(65535) 再 HexToDec 回来 | 65535,往返一致 |
工具函数没有失败通道,非法输入静默给 0,用之前自己把输入洗干净。
十、内存读写、取地址与 SizeOf
内存这组的实测读数(先 AllocMemory(16) 得到全零 16 字节,再 CopyMemory 压入 41 42 43 00 四字节):
| 操作 | 实测读数 | | ReadMemory(m, 4) | blob 四字节,hex 显示 41424300——字节级一致 | | ReadAnsiString(m) | 'ABC'(读到 NUL 截断) | | ReadUtf8String(压入 E4B8AD00) | 长度 1 的字符串——UTF-8 字节被正确解成单个汉字 | | ReadUnicodeString(压入 2D4E0000) | 长度 1——UTF-16LE 编码的同一个字 | | ReadInt(m) | 16961(0x4241) | | ReadLong(m) | 4407873(0x434241) | | AddressOf(long 变量,值 12345) | 地址非 0,ReadInt(该地址) = 12345 | | SizeOf(1) / SizeOf('ab') / SizeOf(blob) | 4 / 4 / 4 |
两条重点解读:
- ReadInt / ReadLong 不是教科书式的定长整读。同一块 41 42 43 00 内存,按小端定长读 int 应该是 0x00434241(4410689),实测却读到 0x4241;对照 AddressOf 用例(值 12345 的内存布局是 39 30 00 00,ReadInt 读回 12345 正确)——两组读数合起来指向「按 NUL 截断的变长读」语义:内存里没有 0x00 时它读不满,读到什么给什么。要按定长读内存,用 ReadMemory 拿回 blob 自己拼,或者用 uo_blob 的类型化 get,别把 ReadInt / ReadLong 当定长读取用。
- SizeOf 量出来恒为 4:int、字符串、blob 全是 4——它量的是 PB 变量引用槽(32 位指针),不是数据本体。想 C 语言式 sizeof 的读者不要抱这个期待。
另外 AddressOf 与 ReadInt 配合是这套内存函数里最可靠的一对:ReadInt(AddressOf(v)) 恒等于 v 本身,实测可用于「把 PB 变量地址交给 DLL 回填」的场景。
十一、回调:把 PB 事件变成 DLL 能调的函数
这是 uo_dll 相对原生声明最大的增值。全链路用 user32 的 EnumWindows(逐个枚举顶层窗口并回调)验证:
- // 目的:注册 PB 事件为回调,统计顶层窗口个数
- // 前置:NVO 里定义实例变量 long il_cnt 与自定义事件:
- // event type long ue_enum ( long ahwnd, long alparam )
- // 事件体:il_cnt = il_cnt + 1 ; return 1 (返回 1 继续枚举)
- uo_dll ld
- int li_cb
- boolean lb
- long ll_r
- il_cnt = 0
- ld = create uo_dll
- lb = ld.LoadFunction('user32.dll', 'EnumWindows', 2)
- li_cb = ld.CreateCallback(2, 2) // STDCALL + 返回类型 LONG
- lb = ld.PushCallbackArgType(li_cb, 2) // 声明第 1 个参数类型:LONG
- lb = ld.PushCallbackArgType(li_cb, 2) // 声明第 2 个参数类型:LONG
- lb = ld.BindCallbackEvent(li_cb, This, 'ue_enum')
- lb = ld.PushCallbackArg(li_cb) // 把回调作为下一个 Invoke 的参数压栈
- ld.PushArg(0) // EnumWindows 的第二个参数 lParam
- lb = ld.Invoke(ll_r) // ll_r = 1,期间 ue_enum 被连触
- ld.FreeFunction()
- destroy ld
- // 本机实测:fired = 306(PB12.5 轨)与 307(PB10 轨,多枚到一个窗口属环境波动)
复制代码
四个步骤一个都不能少,且顺序固定:CreateCallback 拿回调号 → PushCallbackArgType 逐个声明参数类型 → BindCallbackEvent 绑到「本对象的自定义事件」(第二个参数传 This)→ PushCallbackArg 把回调当参数压栈。实测两版都能跑通,窗口计数三百多次,事件体里还能拿到每个窗口的句柄(ahwnd)。
十二、失败形态与边界:哪些静默、哪些会崩
全部负向用例的实测结果(PB10 与 PB12.5 一致):
| 用例 | 实测结果 | | LoadFunctionList('no_such_dll_xyz.dll') | 返 0,不崩 | | LoadFunction('no_such_dll_xyz.dll', 'Foo', 2) | 返 false,不崩 | | LoadFunction('kernel32.dll', 'NoSuchFuncXyz99', 2) | 返 false;随后 Invoke 也返 false 且返回值 0,不崩 | | FreeFunction 之后 Invoke | 返 false,返回值保持旧值(读到陈旧数字要当心) | | 不 Free 直接 LoadFunction 换新函数 | 返 true,新函数立即生效(旧压栈参数被丢弃,需重压) | | PushArg 类型压错(往单指针参数压 double 1.5) | Invoke 返 true,结果 0——不报错不崩,静默给错值 | | LoadFunction 传 mode=1(CDECL)调 STDCALL 函数 | 本例读数正确未崩——但这是栈平衡的侥幸,别当常规用法 | | PushRefArg(0) | 返回 0 | | AllocMemory(0) | 返回非 0 有效地址;对其 ReadMemory(…,4) 还能读出 4 字节(零长度分配可越界读) | | FreeMemory(0) | 无事发生 | | ReadMemory(0, 4)(地址为 0) | 返回 0 长度 blob,不崩 | | LoadFunction 之前 PushRefArg | 崩 0xC0000005——压栈动作必须在加载之后 | | 进程最早期 LoadFunctionList 大 DLL | 概率性崩 0xC0000005(见第四节) |
这张表的价值在第一列和第三列的对比:加载失败全家 false 是温和的;压错参数类型、顺序颠倒、零长度分配这三类才是真雷——前者静默给错值,后两者直接崩进程,而 PB 的 try-catch 接不住 0xC0000005。
十三、PB12.5 差异
本主题全部探针(含崩溃定性用例)在 PB10 与 PB12.5 双轨运行,读数逐字一致,未发现版本差异——行为一致。唯一的读数出入是 EnumWindows 的窗口计数(306 对 307),那是两轨运行时刻系统窗口数确实不同,属于环境波动而非行为差异,特此说明。
十四、坑清单
- PushRefArg 必须在 LoadFunction 之后:顺序颠倒直接崩 0xC0000005,try-catch 接不住;
- 默认 charset 不可信:纯 ASCII 串与含中文串给出两种字节布局(1 对 4),字符串参数永远显式传 1 或 2;
- PushArg 类型压错不报错:double 压进单指针参数,Invoke 照样返 true、结果静默变 0;
- 进程早期枚举大 DLL 概率崩:先做一次文件 IO 热身再 LoadFunctionList;
- ReadInt / ReadLong 是变长读不是定长读:按 NUL 截断,读定长数据用 ReadMemory 自己拼;
- SizeOf 恒 4:量的是引用槽不是数据本体;
- FreeFunction 后 Invoke 返 false 但返回值保持旧值:读数要连返回值一起判;
- AllocMemory(0) 给有效地址还能越界读:零长度分配别当错误判据用;
- HexToDec 非法输入静默返 0:'xyz' 与 '' 都是 0,洗输入靠你自己;
- Hex 大写、DecToHex 小写:字符串比对时注意大小写方向相反;
- HexToDec 居然认 '0x' 前缀:可以利用,但也意味着输入校验比想象中宽;
- CDECL 调 STDCALL 函数本例侥幸正确:栈平衡隐患还在,常规 stdcall API 用默认 mode=2;
- 回调四步顺序固定:CreateCallback → PushCallbackArgType×N → BindCallbackEvent(This) → PushCallbackArg,少一步或乱序即失败;
- LoadFunction 换新函数不报错但旧参数栈被丢弃:换函数后所有参数必须重压;
- 所有 false 都不给原因:排查靠逐参数自查,本文第十二节的失败形态表就是自查清单。
十五、收个尾
uo_dll 把「调用外部 DLL」从编译期搬到了运行期:不用重新编译就能换函数、能枚举导出表、能挂回调,动态插件式的架构在 PB 里第一次变得顺手。代价是它把原来编译器替你把守的类型关打开了——参数压错、编码选错、顺序颠倒,编译期一路绿灯,问题全部推迟到运行期,而且大多以「静默错值」或「直接崩溃」的形态出现。
所以用它的正确姿势是:字符串显式 charset、引用参数先 Load 再 Push、回调四步按顺序、每一步布尔返回值都接住。这四条习惯立住了,uo_dll 就从雷区变成工具箱。
本文全部结论来自双轨实机验证:PB10 与 PB12.5 各自导入全部探针对象、ORCA 全量编译 0 错误、PBVM 运行 PASS、读数逐字比对;崩溃类用例逐例独立运行取证。配套示例代码(含全部探针与自验证脚本)见二楼附件。 |