构建Cython/Python C扩展库时链接额外.lib解决LNK2001错误

你遇到的LNK2001: unresolved external symbol __imp_LogonUserA报错，是因为LogonUserA属于Win32高级API，实现位于advapi32.dll中，编译扩展时需要显式链接对应的导入库advapi32.lib，setuptools默认不会自动链接该系统库。手动调用链接命令出现rc.exe找不到的问题，是因为没有加载VS编译环境的路径变量，完全不需要手动执行链接步骤，通过setuptools配置即可自动完成全流程编译。
另外你的C代码中存在一个会直接导致运行时崩溃的逻辑bug，会在编译通过后触发内存访问错误，需要一并修复。

1. 修改setup.py配置链接依赖库 #

在Extension构造参数中添加libraries字段，指定需要链接的系统库名advapi32，setuptools会自动搜索Windows SDK对应架构的lib路径完成链接，不需要手动配置库目录。
修正后的setup.py代码如下：

from setuptools import setup, Extension

def main():
    setup(name="passcheck",
          version="1.0.0",
          description="Python interface for Win32 LogonUser API to validate account credentials",
          author="no one",
          ext_modules=[
              Extension(
                  "passcheck",
                  ["passcheck.c"],
                  libraries=["advapi32"]  # 指定链接advapi32.lib
              )
          ])

if __name__ == "__main__":
    main()

2. 修复C代码的句柄参数bug #

你原有代码中定义的PHANDLE hToken是未初始化的野指针，直接传给LogonUserA会写入非法内存地址触发崩溃。需要改为定义栈上的HANDLE变量，传入变量地址接收登录返回的令牌句柄，同时在验证完成后关闭句柄避免资源泄漏。
修正后的passcheck.c代码如下：

#include <Python.h>
#include <windows.h>
#include <winbase.h>

static PyObject* method_passcheck(PyObject* self, PyObject* args) {
    LPCSTR username;
    LPCSTR password;
    LPCSTR domain = "."; // 用.表示本地账户，兼容性优于通配符*
    HANDLE hToken = NULL; // 禁止使用未初始化的PHANDLE野指针
    BOOL passwordWorked = FALSE;

    /* 解析输入参数 */
    if (!PyArg_ParseTuple(args, "ss", &username, &password)) {
        return NULL;
    }

    passwordWorked = LogonUserA(
        username,
        domain,
        password,
        LOGON32_LOGON_NETWORK,
        LOGON32_PROVIDER_DEFAULT,
        &hToken // 传入hToken地址接收输出的令牌句柄
    );

    // 验证完成后关闭句柄，避免系统资源泄漏
    if (hToken != NULL) {
        CloseHandle(hToken);
    }

    return PyBool_FromLong(passwordWorked); // 直接返回布尔值符合Python使用习惯
}

static PyMethodDef PasscheckMethods[] = {
    {"passcheck", method_passcheck, METH_VARARGS, "Validate if the given password matches the specified Windows account"},
    {NULL, NULL, 0, NULL}
};

static struct PyModuleDef passcheck = {
    PyModuleDef_HEAD_INIT,
    "passcheck",
    "Windows account password validation module based on LogonUser API",
    -1,
    PasscheckMethods
};

PyMODINIT_FUNC PyInit_passcheck(void) {
    return PyModule_Create(&passcheck);
}

3. 执行构建 #

直接在项目目录执行构建命令即可，setuptools会自动定位VS编译工具链，不会出现rc.exe找不到的问题：

• 要在当前目录生成可直接导入的pyd文件，执行：
  python setup.py build_ext --inplace
• 要打包为标准可安装的Python wheel包，先安装wheel依赖：pip install wheel，再执行：
  python setup.py bdist_wheel
  生成的whl文件位于dist目录下，可以直接通过pip install xxx.whl安装到任意对应版本的Python环境中使用。

• 运行该接口校验本地账户密码需要进程拥有基础的系统权限，普通管理员权限运行Python即可满足本地账户校验需求。
• 如果需要校验域账户，把代码里的domain参数从.改为对应的域名即可。

内容的提问来源于stack exchange，提问作者Spider Boy