取汇编上次失败原因 - GetAsmLastError

接口 ID 149　|　分类：汇编　|　定义文件：x64GamePlug.idl

作用说明

取 AsmAdd / AsmCall 上次失败的原因（中文说明），成功时返回空串

本方法无需传入参数。

VC++ 调用示例（x64，控制台工程）

// 说明：本示例为完整 x64 控制台工程，整段复制覆盖新建控制台工程的 main.cpp 即可编译运行。
//   1. VS2019 新建「控制台应用」，项目属性 -> 平台选 x64，才能加载 64 位 DLL。
//   2. 项目属性 -> C/C++ -> 预编译头 -> 改为「不使用预编译头」，否则默认找 pch.h 会报 C1010。
//   3. 把 x64Game-Plug.dll 放到 exe 同目录（#import 与免注册加载都需要）。
//   4. 源码保存为 UTF-8 带 BOM，避免中文乱码；全站用 regsvr32 注册也可（需管理员）。
#include <iostream>
#include <clocale>
#include <windows.h>
#include <comdef.h>

// 免注册加载：用 IGamePlug 智能指针装载
// rename 是为避开 windows.h 的 FindWindow 宏冲突，接口里的 FindWindow 在 C++ 侧改名为 FindWindowGP
#import "x64Game-Plug.dll" no_namespace rename("FindWindow", "FindWindowGP")

static HMODULE      g_hDll = NULL;
static IGamePlugPtr g_plug;

// ---------- 免注册：加载 DLL 并创建对象（发布时把 DLL 放 exe 同目录）----------
static bool LoadPlug() {
    const wchar_t* paths[] = {
        L"x64Game-Plug.dll",
        L"..\x64Game-Plug.dll"
    };
    for (int i = 0; i < (int)(sizeof(paths) / sizeof(paths[0])); ++i) {
        g_hDll = ::LoadLibraryW(paths[i]);
        if (g_hDll) break;
    }
    if (!g_hDll) {
        std::cout << "LoadLibrary failed: put x64Game-Plug.dll next to the exe" << std::endl;
        return false;
    }
    typedef HRESULT (__stdcall *GamePlugCreateFn)(IGamePlug**);
    GamePlugCreateFn fn = (GamePlugCreateFn)::GetProcAddress(g_hDll, "GamePlugCreate");
    if (!fn) { std::cout << "GetProcAddress GamePlugCreate failed" << std::endl; return false; }
    HRESULT hr = fn(&g_plug);
    if (FAILED(hr)) { std::cout << "GamePlugCreate failed: 0x" << std::hex << hr << std::endl; return false; }
    return true;
}
int main() {
    if (!LoadPlug()) { system("pause"); return 1; }
    // ---------- 调用插件本命令方法如下 ----------
    try {
        _bstr_t s = g_plug->GetAsmLastError();
        std::wcout << L"上次失败原因: " << (wchar_t*)s << std::endl;
    } catch (_com_error& e) {
        std::wcout << L"COM error: " << e.ErrorMessage() << std::endl;
    }

    g_plug->Release();
    system("pause");
    return 0;
}

返回值

返回本线程上一次 AsmAdd / AsmCall 失败的中文说明；最近一次操作成功、或还没调用过这两个方法时返回空串。

常见注意事项

• 汇编文本按 Intel 语法书写；AsmAdd 返回的大写十六进制串可以直接拼接成完整机器码，再交给 AsmCall 执行。两个方法失败时都返回空串而不是抛异常，请用 GetAsmLastError 查中文原因。
• 错误串与「最近一次翻译用的位数」都是线程本地状态：同一线程内各次调用互相衔接，跨线程不共享；多线程调用时请在各自线程里组织同一段代码的翻译与执行。
• 错误串是 thread_local 线程本地状态：每个线程各记各的，多线程互不干扰。要在「同一个线程里、紧接着失败的 AsmAdd / AsmCall」取，跨线程或中间隔了别的调用，读到的就不是那次失败的原因了。
• 每次 AsmAdd / AsmCall 开始时都会先清空错误串，成功后保持为空。因此返回空串既可能是「最近一次操作成功」，也可能是「本线程还没调用过这两个方法」，不能单凭它判断成败。
• 只在 AsmAdd / AsmCall 返回空串（失败）时查看本方法才有意义；它只是读取说明，不会清除或改变记录。
• 本方法为免费功能，无需授权码，直接调用即可。