Signature API

作用

Signature API 用于在已加载模块中解析函数名或字节特征码，返回匹配地址。

头文件

C:

#include <pl/c/Signature.h>

C++:

#include <pl/cpp/Signature.hpp>

类型签名

PLAPI uintptr_t pl_resolve_signature(const char *signature,
                                     const char *moduleName);

C++：

namespace pl::signature {
uintptr_t resolveSignature(const std::string &signature,
                           const std::string &moduleName);
std::unordered_map<std::string, uintptr_t>
resolveSignatures(const std::vector<std::string> &signatures,
                  const std::string &moduleName);
}

pl_resolve_signature

作用

按函数名或字节 pattern 解析地址。

参数

参数	说明
signature	函数名或字节 pattern，不能为 NULL
moduleName	模块名或路径片段，不能为 NULL

返回值

返回匹配地址。失败返回 0。

Pattern 格式

支持空格分隔或连续十六进制字节：

48 8B ?? ?? 89
488B????89

通配符：

写法	说明
?	整字节通配
??	整字节通配
A?	低 4 bit 通配
?F	高 4 bit 通配

C 示例

#include <pl/c/Signature.h>

uintptr_t addr = pl_resolve_signature("SomeSymbol", "libminecraftpe.so");
if (addr == 0) {
  addr = pl_resolve_signature("48 8B ?? ?? 89", "libminecraftpe.so");
}

C++ 批量示例

#include <pl/cpp/Signature.hpp>

auto results = pl::signature::resolveSignatures(
    {"SymbolA", "48 8B ?? ?? 89"},
    "libminecraftpe.so");

uintptr_t symbolA = results["SymbolA"];

注意事项

• moduleName 应匹配目标库名称。
• pattern 为空或格式非法时返回 0。
• 批量解析多个 signature 时优先使用 resolveSignatures，避免重复扫描。