# raw.peFile 库模块帮助文档

[💻 范例：DLL 查看工具](https://www.aardio.com/zh-cn/docs/examples/File/PE/DLLView.html)

## raw 成员列表 <a id="raw" href="#raw">&#x23;</a>

### raw.peFile() <a id="raw.peFile" href="#raw.peFile">&#x23;</a>
[返回对象:rawPeFileObject](#rawPeFileObject)

### raw.peFile(path) <a id="raw.peFile" href="#raw.peFile">&#x23;</a>
参数指定 PE 文件路径。

## raw.peFile 成员列表 <a id="raw.peFile" href="#raw.peFile">&#x23;</a>

用于分析 PE 文件。  
用法请参考「 aardio 工具 » 探测器 » DLL 查看工具 」

### raw.peFile.findDll(name,dir) <a id="raw.peFile.findDll" href="#raw.peFile.findDll">&#x23;</a>
按系统加载 DLL 的查找规则（先查 @dir 目录，再按 LoadLibrary 搜索顺序）查找依赖 DLL，  
返回完整路径；api-ms-*/ext-ms-* 返回 "apiset"；找不到返回 null

### raw.peFile.getTime(path) <a id="raw.peFile.getTime" href="#raw.peFile.getTime">&#x23;</a>
返回使用 PE 时间戳作为参数创建的 time 对象。  
参数 @path 指定文件路径。

### raw.peFile.inspect(路径) <a id="raw.peFile.inspect" href="#raw.peFile.inspect">&#x23;</a>
一句探查 PE 文件：打开、summary()、关闭，返回摘要表（字段见 summary）。  
参数为目录时递归扫描其中的 *.dll|*.exe|*.ocx|*.pyd|*.node|*.sys 并返回摘要数组（每项含 path）。  
打开失败返回 null,错误信息。  
下载或编译出 DLL 后先用它看：machine 是否 x86、是否 .NET、缺哪些依赖、导出了什么、调用约定线索（notes 字段有现成的提示）。

### raw.peFile.setTime(path,tm) <a id="raw.peFile.setTime" href="#raw.peFile.setTime">&#x23;</a>
设置 PE 时间戳。  
参数 @path 指定文件路径。  
参数 @tm 可以是数值或 time 对象。

### raw.peFile.verifyFile(path,required,options) <a id="raw.peFile.verifyFile" href="#raw.peFile.verifyFile">&#x23;</a>
一句全自动验证 DLL：打开、verify(required,options)、关闭。  
参数 @path 指定文件路径，@required 可选指定必须存在的导出函数名数组，@options 见 verify 函数。  
返回 verify 的结果表 {ok,errors,error,missing,missingDependencies,exports,info}，打开失败返回 null,错误信息。  
典型用法：tcc 编译 DLL 后 var r = raw.peFile.verifyFile(path,{"fn1","fn2"},{load=true}); if(!r.ok) error(r.error)

## rawPeFileObject 成员列表 <a id="rawPeFileObject" href="#rawPeFileObject">&#x23;</a>

### rawPeFileObject.close() <a id="rawPeFileObject.close" href="#rawPeFileObject.close">&#x23;</a>
关闭文件，对象被回收时也会自动调用此函数。

### rawPeFileObject.exportDeclaration() <a id="rawPeFileObject.exportDeclaration" href="#rawPeFileObject.exportDeclaration">&#x23;</a>
导出 aardio 格式的导出函数声明，  
仅支持使用C++修饰名导出的 API 函数,  
导出的 aardio 代码仅供参考。

### rawPeFileObject.getClrHeader() <a id="rawPeFileObject.getClrHeader" href="#rawPeFileObject.getClrHeader">&#x23;</a>
获取 .Net 程序的 CLR 头信息  
如果不是 .Net 程序返回 null

### rawPeFileObject.getDataDirectory(索引) <a id="rawPeFileObject.getDataDirectory" href="#rawPeFileObject.getDataDirectory">&#x23;</a>
读取 PE 数据目录，参数指定 0 起的目录索引（0 导出表，1 导入表，13 延迟加载表，14 CLR 头）。  
返回 {address=RVA;size=大小}，不存在返回 null。

### rawPeFileObject.getDelayImportDirectory() <a id="rawPeFileObject.getDelayImportDirectory" href="#rawPeFileObject.getDelayImportDirectory">&#x23;</a>
返回延迟加载（delay-load）导入表信息，  
每个数组成员包含 name 字段（DLL 名）。  
无延迟加载表返回 null。

### rawPeFileObject.getExportDirectory() <a id="rawPeFileObject.getExportDirectory" href="#rawPeFileObject.getExportDirectory">&#x23;</a>
返回导出表信息,失败或无导出表返回 null。  
用法请查看函数源码

### rawPeFileObject.getExportEntries() <a id="rawPeFileObject.getExportEntries" href="#rawPeFileObject.getExportEntries">&#x23;</a>
返回一个包含所有导出函数名信息的对象数组。  
每个数组成员包含 "ordinal";"address";"name" 三个字段  
返回对象的 fields 属性是一个列名数组,  
返回对象可以作为 listview 控件的 setTable 函数参数使用  

失败或无导出表返回 null。

### rawPeFileObject.getExportNames() <a id="rawPeFileObject.getExportNames" href="#rawPeFileObject.getExportNames">&#x23;</a>
返回一个包含所有导出函数名的字符串数组。  
失败或无导出表返回 null。

### rawPeFileObject.getImportDirectory() <a id="rawPeFileObject.getImportDirectory" href="#rawPeFileObject.getImportDirectory">&#x23;</a>
返回导入表信息,  
用法请查看函数源码

### rawPeFileObject.getSectionByName() <a id="rawPeFileObject.getSectionByName" href="#rawPeFileObject.getSectionByName">&#x23;</a>
返回参数 @1 指定名称的 PE 节信息。

### rawPeFileObject.imageBase <a id="rawPeFileObject.imageBase" href="#rawPeFileObject.imageBase">&#x23;</a>
首选加载基址（数值）

### rawPeFileObject.imageHeader.timeDate <a id="rawPeFileObject.imageHeader.timeDate" href="#rawPeFileObject.imageHeader.timeDate">&#x23;</a>
PE 文件创建时间，time 对象  

[返回对象:timeObject](https://www.aardio.com/zh-cn/docs/library-reference/time/_.html#timeObject)

### rawPeFileObject.imageHeader.timeDateStamp <a id="rawPeFileObject.imageHeader.timeDateStamp" href="#rawPeFileObject.imageHeader.timeDateStamp">&#x23;</a>
PE 文件创建时间戳，数值

### rawPeFileObject.isDll <a id="rawPeFileObject.isDll" href="#rawPeFileObject.isDll">&#x23;</a>
是否 DLL（文件头 characteristics 含 IMAGE_FILE_DLL）

### rawPeFileObject.isImported("字符串参数") <a id="rawPeFileObject.isImported" href="#rawPeFileObject.isImported">&#x23;</a>
检测是否导入了指定的 DLL,名称忽略大小写

### rawPeFileObject.isPe32 <a id="rawPeFileObject.isPe32" href="#rawPeFileObject.isPe32">&#x23;</a>
是否 PE32 文件。  
process.isExe 也可以用于检测 32 位或 64 位执行文件

### rawPeFileObject.machine <a id="rawPeFileObject.machine" href="#rawPeFileObject.machine">&#x23;</a>
目标架构名称，"x86"、"x64"、"arm64"、"arm"、"ia64" 之一，未知则为十六进制字符串。  
32 位 aardio 进程只能 raw.loadDll 加载 "x86" 模块。

### rawPeFileObject.majorLinkerVersion <a id="rawPeFileObject.majorLinkerVersion" href="#rawPeFileObject.majorLinkerVersion">&#x23;</a>
链接器主版本号

### rawPeFileObject.minorLinkerVersion <a id="rawPeFileObject.minorLinkerVersion" href="#rawPeFileObject.minorLinkerVersion">&#x23;</a>
链接器副版本号

### rawPeFileObject.path <a id="rawPeFileObject.path" href="#rawPeFileObject.path">&#x23;</a>
文件路径

### rawPeFileObject.read({int number}) <a id="rawPeFileObject.read" href="#rawPeFileObject.read">&#x23;</a>
读取结构体  
不支持多参数

### rawPeFileObject.read(字节数) <a id="rawPeFileObject.read" href="#rawPeFileObject.read">&#x23;</a>
读取指定长度的字节  
不支持多参数

### rawPeFileObject.rvaToOffset(RVA) <a id="rawPeFileObject.rvaToOffset" href="#rawPeFileObject.rvaToOffset">&#x23;</a>
将 RVA 转换为文件偏移，无法映射返回 null

### rawPeFileObject.sections <a id="rawPeFileObject.sections" href="#rawPeFileObject.sections">&#x23;</a>
PE 节信息数组。

### rawPeFileObject.seek("set",) <a id="rawPeFileObject.seek" href="#rawPeFileObject.seek">&#x23;</a>
移动至相对开始处的指定偏移量

### rawPeFileObject.subsystem <a id="rawPeFileObject.subsystem" href="#rawPeFileObject.subsystem">&#x23;</a>
子系统数值，2 为 GUI，3 为 CUI

### rawPeFileObject.summary() <a id="rawPeFileObject.summary" href="#rawPeFileObject.summary">&#x23;</a>
返回 PE 文件摘要表，字段：  
path,machine("x86"/"x64"/"arm64"…),bits,isDll,subsystem,linker,timeDate,toolchain,  
exports（导出函数名数组）,exportCount,dependencies（导入 DLL 名）,delayDependencies,missingDependencies（按系统搜索规则找不到的依赖）,  
dotNet（.NET 程序集信息：ilOnly,platform,runtime）,isComServer,calling（x86 导出名修饰推断的调用约定，无修饰为 null，混合为 "mixed"）,  
loadable（当前 32 位进程能否 raw.loadDll）,notes（给人看的提示数组）。  
静态函数 raw.peFile.inspect(path) 可一步完成打开、summary、关闭。

### rawPeFileObject.verify(required,options) <a id="rawPeFileObject.verify" href="#rawPeFileObject.verify">&#x23;</a>
全自动验证 DLL 能否在 aardio 中使用，一次列出所有问题。  
参数 @required 可选指定必须存在的导出函数名数组（或单个函数名）。  
参数 @options 可选指定表：  
- machine 要求的架构，默认 "x86"，指定 "any" 不检查  
- allowDotNet 允许纯 .NET 程序集，默认 false  
- allowExe 允许 EXE，默认 false  
- checkDependencies 检查依赖 DLL 是否都能找到，默认 true  
- load 为 true 则真实调用 LoadLibrary 加载一次（会执行 DllMain）并用 GetProcAddress 核对 required  
返回表：ok=是否全部通过，errors=问题描述数组，error=问题合并文本或 null，  
missing=缺少的导出函数名，missingDependencies=缺少的依赖 DLL，exports=导出函数名数组，info=summary() 摘要，  
loaded=真实加载是否成功（仅 load=true 时）。

### rawPeFileObject.verifyExports(required) <a id="rawPeFileObject.verifyExports" href="#rawPeFileObject.verifyExports">&#x23;</a>
仅验证 DLL 是否包含 required 数组中的全部导出函数名。  
参数 @required 指定必须存在的导出函数名字符串数组。  
返回表：ok=是否全部存在，missing=缺少的函数名数组，exports=完整导出函数名数组  
完整验证请用 verify 函数。
