Repository files navigation

⚠ NOTICE:Check out CsWin32: A new, preferred approach for Win32 p/invokes now exists for C# developers.

This repo is no longer maintained.

A collection of libraries intended to contain all P/Invoke method signatures for popular operating systems.Think of it ashttps://pinvoke.net, but proven to compile and work properly, and oftenwith sample usage in the form of unit tests.

A unique C# project wraps each native library.The C# project may multi-target in order to support many versions of .NET Framework, .NET Core and .NET Standard.

Win32 APIs for all Windows versions are welcome.Special Windows Store targeted assemblies omit p/invoke signatures to banned APIs so your Store apps can depend on these libraries without getting rejected by the Store certification process.

This project is supported by the.NET Foundation.

Install the NuGet package(s) for the DLLs you want to P/Invoke into.For example, if you want to P/Invoke into Win32's BCrypt.dll, install this package:

Install-Package PInvoke.BCrypt

Then import the following namespaces, as demonstrated below (if using C# 6):

usingPInvoke;usingstaticPInvoke.BCrypt;// Supported in C# 6 (VS2015) and later.

This will allow you to conveniently call these methods directly by method name:

varerror=BCryptOpenAlgorithm(AlgorithmIdentifiers.BCRYPT_SHA256_ALGORITHM);// C# 6 syntaxvarerror=BCrypt.BCryptOpenAlgorithm(BCrypt.AlgorithmIdentifiers.BCRYPT_SHA256_ALGORITHM);// C# 5 syntax

Sometimes a PInvoke method may have multiple overloads. For example every method that acceptsstruct* parameters has an overload that acceptsIntPtr in its place. In other cases theremay be overloads that acceptstruct* andstruct?. In some of these cases that can lead tocompiler errors if you pass innull because bothstruct* andstruct? overloads can match.To resolve the issue, add a cast to your null:(struct?)null to resolve the ambiguity.

Cast anyuint to specificenum type and pass as parameter.

Provide a slightly higher than lowest level API for P/Invoke signatures.For example, instead ofIntPtr parameters anduint flags, you'll seeSafeHandle-derivedtypes as parameters and flagsenum types. API documentation will be provided via XML doc commentsfor easy reading with Intellisense, along with links to the describing pages on MSDNor elsewhere as applicable.

In some cases we offer several overloads of a given native method to offer native pointer andIntPtr access. We encourage folks to try writing C#unsafe code before usingIntPtr becauseit (ironically) can often be easier to write correct and efficient code using native pointers thanall the casting andMarshal call overhead thatIntPtr requires.Note that when a method's only use of a native pointer is its return type, theIntPtr returningvariant must be given a different method name by CLR overloading rules, so look for the same methodbut with an_IntPtr suffix.

This library should be available on NuGet for easy consumption by your projects.You may also copy and paste the P/Invoke signatures you need directly into your projects if desired.

Packages:

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

Check out theP/Invoke coverage we have for each library.

If you need a P/Invoke that is in our source code but not yet released to nuget.org, you can consume the packages directly from our CI feed by adding this package source to your nuget.config file

<addkey="PInvoke"value="https://pkgs.dev.azure.com/andrewarnott/OSS/_packaging/PublicCI/nuget/v3/index.json" />

Please considercontributing more P/Invoke method signatures to this project.Once you contribute, you can immediately consume your additions without waiting for anotherpublic release of the library.

This project has adopted the code of conduct defined by the Contributor Covenant to clarify expected behavior in our community.For more information see the.NET Foundation Code of Conduct.