# win32exts_for_Lua

**Repository Path**: rrtddr/win32exts_for_Lua

## Basic Information

- **Project Name**: win32exts_for_Lua
- **Description**: https://github.com/tankaishuai/win32exts_for_Lua
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2023-03-07
- **Last Updated**: 2023-03-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README


======================================

# win32exts 多语言 外部编程接口扩展

**脚本语言通用 Win32 FFI调用引擎简介**


![markdown](https://www.mdeditor.com/images/logos/markdown.png "markdown")


    一直希望有这样的一种统一江湖的脚本语言：
    
既拥有脚本语言的动态解释执行能力，又拥有接近如C/C++般高效的执行效率，同时还具有如C/C++甚至汇编语言般强大的功能，可以直接调用系统功能。语言干净简练、子功能模块库丰富多彩，同时作为嵌入式脚本也能得心应手。

**可惜没有！**

    常见的语言如lua, js, vbs, Python, PowerShell 都或多或少存在一些问题。PowerShell 语法过于诡异，
    
    更接近于一种增强版的批处理脚本。Js/vbs/lua 使用方便，但原生功能较弱。Python拥有强大的第三方库，但打包部署麻烦。
    
    于是，才有了大千世界、芸芸众生，各种语言的各领风骚。


## 言归正传。

    笔者在开发过程中各种语言均有接触（当然更亲赖Python和Lua，毕竟作为嵌入式脚本非常合适）。经常摆在面前的问题是，
    
    某语言在特定平台上需要直接调用系统API才能实现某些功能的问题。
    
    当然，各种语言都有提供一些外部函数扩展（FFI）的方式。通常是需要自己编写一个模块(DLL)或者额外的脚本，难免有点愚拙。
    
    所以此处只考虑一种无须额外写太多第三方库，实现统一调用任意系统API的机制。
    
**目前主要流行的语言中，已有一些FFI支持库：**


![Pandao editor.md](https://pandao.github.io/editor.md/images/logos/editormd-logo-180x180.png "Pandao editor.md")

    各种扩展库语法差异极大，并且有些需要带上庞大数量的支持库，有些功能又极为简略，不能适应较为复杂的函数调用
    
    （典型的如EnumWindows类带回调的，以及匿名函数、变参数目等的调用）。

    因此，笔者开发的win32exts扩展框架旨在谋求一种 【发布简单】的(一个模块)，【统一的】(各种脚本中语法基本一致)，
    
    【高效的】、【功能强大】 的(原生API,COM,C++非COM接口成员均支持)模式。

**一句话，有了 win32exts，真正实现 Do whatever you want，放之四海而皆准是也。**


### 以Python为例(其他语言其实差不多长一个样吧)，

### win32exts调用的基本用法如下：

（1）常规具名函数（以MessageBoxA/W为例）调用：

导入模块符号。第一个参数为待加载的模块名，可以带路径，传入"*"表示当前进程的所有模块；

第二个参数表示函数符号名称，传入"\*"表示该模块的所有符号。

win32exts.load_sym("\*", "\*")

或 win32exts.load_sym("C:\\windows\\system32\\user32.dll", "MessageBoxW")

或 win32exts.load_sym("user32", "MessageBoxA")

或 win32exts.load_sym("user32", "\*")

win32exts.MessageBoxA(0, "call MessageBoxA", "", 1)

宽字符需要用 win32exts.L() 包装，与C/C++雷同。

win32exts.MessageBoxW(0, win32exts.L("call MessageBoxW"), None, 1)


（2）带回调的函数（以EnumWindows为例）调用：

先分配一块内存后面用：

	g_buf = win32exts.malloc(2*260)

定义一个回调函数：
	
	
	def EnumWndProc(args):   
		【args为参数包，以下取参数】
		hWnd = win32exts.arg(args, 1)
		lParam = win32exts.arg(args, 2)
		
		win32exts.GetWindowTextW(hWnd, g_buf, 260)
		【读取内存中的宽字符串】
		【read_***系列接口读内存，write_***系列接口写内存】
		strText = win32exts.read_wstring(g_buf, 0, -1)
	
		win32exts.MessageBoxW(0, win32exts.L(strText), g_buf, 1)

		strRetVal = "1, 8"
		g_index = g_index + 1
		if g_index > 3:   【假设只弹框三次】
			strRetVal = "0, 8"
	
		【返回值是形如这样的字符串: "回调返回值, 参数字节数",
		对于 cdecl 调用约定，参数字节数总是取 0 】
		return strRetVal

然后调用：

	win32exts.EnumWindows(win32exts.callback("EnumWndProc"), 0)

win32exts.callback（）用于包装一个Python回调函数。

对于js/lua 等等语言来说，没有提供该函数，直接传入即可，亦即：

	win32exts.EnumWindows(EnumWndProc, 0)

（3）匿名（非具名）函数调用：

假设通过某个接口获取了某函数的地址 lFuncAddr，然后可以类似下述方式调用：

	win32exts.push_value(arg1)     【参数是整数】
	win32exts.push_wstring("arg2") 【参数是宽字符串】
	win32exts.push_astring(arg3)   【参数是多字节字符串】
	win32exts.push_double(arg4)    【参数是双精度浮点数】
	win32exts.push_float(arg5)     【参数是单精度浮点数】
	iRetVal = win32exts.call( lFuncAddr )

当然具名函数也可以类似调用，例如：

	win32exts.push_value(0)
	
	win32exts.push_astring("Py_MessageBoxA_V1")
	
	win32exts.push_value(0)
	
	win32exts.push_value(0)
	
	iRetVal = win32exts.sym_call("MessageBoxA")  【或用 func_call】



# 实在编不下去了（←___←b'），下面是 win32exts 提供的接口分类清单, 至于典型用法请参考git上的 win32exts_for_Xxxx 仓库的demo 示例。

![win32exts](https://github.com/tankaishuai/win32exts_for_Python/blob/master/API/b1.jpg)
![win32exts](https://github.com/tankaishuai/win32exts_for_Python/blob/master/API/b2.jpg)

当然，也可以通过 VS的对象查看器 或者 Python 的 win32exts.help() 命令查看详细API信息：

![win32exts](https://github.com/tankaishuai/win32exts_for_Python/blob/master/API/a1.jpg)
![win32exts](https://github.com/tankaishuai/win32exts_for_Python/blob/master/API/a2.jpg)
![win32exts](https://github.com/tankaishuai/win32exts_for_Python/blob/master/API/a3.jpg)