在调用 win32 库的时候,小伙伴会遇到的问题是不知道对应的 win32 函数应该如何写。或者在网上抄了的代码的实现都有些诡异,想要自己封装发现工作量太大。好消息是官方将 PInvoke 库在 dotnet 基金会完全开源,包含了大量的 Win32 库,如 gdi32.dll 和 kernel32.dll 和 user32.dll 等

使用官方的库的优势是什么呢?第一个就是减少从网上复制粘贴有趣的 PInvoke 调用实现,其次是质量上能保底。虽然官方的实现也不够完美,例如 User32 的 GetWindowLong 方法依然有坑。但是因为此项目是在 github 开源 因此也会有大量的小伙伴入坑不断的修复,相对来说应该会比自己实现的好一些

现在官方已经将大量的 dll 进行了封装

已经实现的 dll 如下

Library Package name NuGet Description
advapi32.dll PInvoke.AdvApi32 NuGet Windows Advanced Services
bcrypt.dll PInvoke.BCrypt NuGet Windows Cryptography API: Next Generation
cabinet.dll PInvoke.Cabinet NuGet Cabinet API Functions
cfgmgr32.dll PInvoke.CfgMgr32 NuGet Device and Driver Installation
crypt32.dll PInvoke.Crypt32 NuGet Windows Cryptography API
DwmApi.dll PInvoke.DwmApi NuGet Desktop Window Manager
fusion.dll PInvoke.Fusion NuGet .NET Framework Fusion
gdi32.dll PInvoke.Gdi32 NuGet Windows Graphics Device Interface
hid.dll PInvoke.Hid NuGet Windows Human Interface Devices
iphlpapi.dll PInvoke.IPHlpApi NuGet IP Helper
kernel32.dll PInvoke.Kernel32 NuGet Windows Kernel API
magnification.dll PInvoke.Magnification NuGet Windows Magnification API
mscoree.dll PInvoke.MSCorEE NuGet .NET Framework CLR host
msi.dll PInvoke.Msi NuGet Microsoft Installer
ncrypt.dll PInvoke.NCrypt NuGet Windows Cryptography API: Next Generation
netapi32.dll PInvoke.NetApi32 NuGet Network Management
newdev.dll PInvoke.NewDev NuGet Device and Driver Installation
ntdll.dll PInvoke.NTDll NuGet Windows NTDll
psapi.dll PInvoke.Psapi NuGet Windows Process Status API
setupapi.dll PInvoke.SetupApi NuGet Windows setup API
SHCore.dll PInvoke.SHCore NuGet Windows Shell
shell32.dll PInvoke.Shell32 NuGet Windows Shell
user32.dll PInvoke.User32 NuGet Windows User Interface
userenv.dll PInvoke.Userenv NuGet Windows User Environment
uxtheme.dll PInvoke.UxTheme NuGet Windows Visual Styles
winusb.dll PInvoke.WinUsb NuGet USB Driver
WtsApi32.dll PInvoke.WtsApi32 NuGet Windows Remote Desktop Services

那如何使用这个库?在 dotnet 里面使用库都是统一使用 NuGet 的方法,在 NuGet 里面按照自己的需要安装对应的库就可以了

如我想要调用 Kernel32 的 CreateProcess 方法,这个方法里面包含了很多结构体等的实现,如果要我自己去找这些结构体的实现,那么我也许会复制到坑代码。而在使用库的时候,我可以在 csproj 添加下面代码安装 NuGet 库

    <ItemGroup>
        <PackageReference Include="PInvoke.Kernel32" Version="0.6.49" />
    </ItemGroup>

此时我就可以通过 Kernel32 类拿到对应的函数和结构体,请看代码

using PInvoke;

            var startupInfo = new Kernel32.STARTUPINFO()
            {
                dwX = 300, // X
                dwY = 300, // Y
                dwXSize = 1000, // 宽度
                dwYSize = 300,  // 高度
                dwFlags = Kernel32.StartupInfoFlags.STARTF_USESHOWWINDOW,
            };
            
            Kernel32.PROCESS_INFORMATION processInformation;
            var creationFlag = Kernel32.CreateProcessFlags.NORMAL_PRIORITY_CLASS | Kernel32.CreateProcessFlags.CREATE_UNICODE_ENVIRONMENT;

            var processSecurityAttribute = Kernel32.SECURITY_ATTRIBUTES.Create();
            var threadAttribute = Kernel32.SECURITY_ATTRIBUTES.Create();

            Kernel32.CreateProcess
            (
                lpApplicationName: @"C:\windows\notepad.exe",
                lpCommandLine: " ",
                lpProcessAttributes: processSecurityAttribute,
                lpThreadAttributes: threadAttribute, 
                bInheritHandles: false,
                dwCreationFlags: creationFlag,
                lpEnvironment: IntPtr.Zero,
                lpCurrentDirectory: null,
                lpStartupInfo: ref startupInfo,
                lpProcessInformation: out processInformation
            );

            Console.WriteLine(Kernel32.GetLastError());

            var process = Process.GetProcessById(processInformation.dwProcessId);
            Console.WriteLine(process.Id);

本文代码放在 github 欢迎小伙伴访问


本文会经常更新,请阅读原文: https://dotnet-campus.github.io//post/%E6%8E%A8%E8%8D%90%E5%AE%98%E6%96%B9%E5%BC%80%E6%BA%90-PInvoke-%E5%BA%93-%E5%8C%85%E5%90%AB%E5%A4%A7%E9%87%8F-win32-%E5%B0%81%E8%A3%85.html ,以避免陈旧错误知识的误导,同时有更好的阅读体验。

知识共享许可协议 本作品采用 知识共享署名-非商业性使用-相同方式共享 4.0 国际许可协议 进行许可。欢迎转载、使用、重新发布,但务必保留文章署名 lindexi (包含链接: https://dotnet-campus.github.io/ ),不得用于商业目的,基于本文修改后的作品务必以相同的许可发布。如有任何疑问,请 与我联系