如何通过DllImport/P/Invoke正确调用WaitOnAddress及api-ms-*系列DLL函数？

这个问题挺常见的——Windows的API集（那些api-ms-*开头的DLL）确实容易让人困惑，我来帮你理清楚调用这类函数的最佳实践：

先搞懂api-ms-* DLL是什么 #

这些带api-ms-前缀的文件并不是真正的实现DLL，而是API集转发器——它们的作用是把API调用定向到实际的系统实现DLL（比如kernel32.dll、ntdll.dll）。微软设计API集是为了更灵活地管理不同Windows版本的API分发，但它们属于系统内部的抽象层，不应该作为你代码里的直接依赖。

最佳实践1：优先使用官方文档标注的核心系统DLL #

你提到直接用[DllImport("kernel32.dll")]调用失败，而且dumpbin查不到导出，这大概率不是kernel32.dll没有这个函数，而是以下原因：

• 架构匹配问题：如果是32位程序在64位系统上，dumpbin默认查的是C:\Windows\System32\kernel32.dll（64位），但你的程序实际加载的是C:\Windows\SysWOW64\kernel32.dll（32位），可以试试指定路径查对应架构的导出；
• DllImport声明错误：WaitOnAddress的正确托管声明应该是这样的，注意参数类型和SetLastError设置：

  [DllImport("kernel32.dll", SetLastError = true)]
  public static extern bool WaitOnAddress(
      IntPtr address,
      IntPtr compareAddress,
      uint size,
      uint dwMilliseconds);
  

  错误的参数类型（比如用int代替uint）或缺少SetLastError都会导致调用失败，还会让你无法通过Marshal.GetLastWin32Error()排查问题。

官方文档明确标注WaitOnAddress属于kernel32.dll，直接引用它才是跨Windows版本的正确姿势——API集DLL的命名和版本绑定到特定系统版本，直接用它们会导致低版本系统加载失败。

最佳实践2：用动态加载+版本检测做兼容 fallback #

如果你需要兼容多个Windows版本（比如同时支持Windows 7和Windows 10），可以在运行时动态加载函数，而不是静态DllImport：

using System;
using System.Runtime.InteropServices;

public static class Win32Api
{
    private delegate bool WaitOnAddressDelegate(
        IntPtr address,
        IntPtr compareAddress,
        uint size,
        uint dwMilliseconds);

    private static WaitOnAddressDelegate _waitOnAddress;

    public static bool WaitOnAddress(IntPtr address, IntPtr compareAddress, uint size, uint dwMilliseconds)
    {
        _waitOnAddress ??= LoadWaitOnAddress();
        return _waitOnAddress?.Invoke(address, compareAddress, size, dwMilliseconds) ?? false;
    }

    private static WaitOnAddressDelegate LoadWaitOnAddress()
    {
        // 先尝试从kernel32.dll加载
        IntPtr kernel32 = LoadLibrary("kernel32.dll");
        if (kernel32 != IntPtr.Zero)
        {
            IntPtr procAddr = GetProcAddress(kernel32, "WaitOnAddress");
            if (procAddr != IntPtr.Zero)
            {
                return Marshal.GetDelegateForFunctionPointer<WaitOnAddressDelegate>(procAddr);
            }
        }

        // 作为 fallback，尝试加载API集DLL（仅针对不支持直接从kernel32导出的旧系统）
        IntPtr apiSetDll = LoadLibrary("api-ms-win-core-synch-l1-2-0.dll");
        if (apiSetDll != IntPtr.Zero)
        {
            IntPtr procAddr = GetProcAddress(apiSetDll, "WaitOnAddress");
            if (procAddr != IntPtr.Zero)
            {
                return Marshal.GetDelegateForFunctionPointer<WaitOnAddressDelegate>(procAddr);
            }
        }

        throw new PlatformNotSupportedException("WaitOnAddress is not supported on this system.");
    }

    [DllImport("kernel32.dll", CharSet = CharSet.Unicode, SetLastError = true)]
    private static extern IntPtr LoadLibrary(string lpFileName);

    [DllImport("kernel32.dll", CharSet = CharSet.Ansi, SetLastError = true)]
    private static extern IntPtr GetProcAddress(IntPtr hModule, string lpProcName);
}

这种方式既保证了主流系统的兼容性，又能在特殊情况下 fallback 到API集DLL。

最佳实践3：避免直接依赖api-ms-* DLL #

除非你有特殊的系统适配需求，否则永远不要把api-ms-* DLL作为直接依赖：

• 这些DLL的命名规则可能随Windows版本变化，比如Windows 8的api-ms-win-core-synch-l1-2-0.dll在Windows 11可能有更新的版本；
• 低版本Windows（比如Windows 7）可能不存在某些高版本的API集DLL，直接引用会导致程序启动失败。

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