Vanara

このプロジェクトには、Windowsライブラリからの機能、インターフェイス、酵素、構造を呼び出すさまざまな.NETアセンブリが含まれています。各アセンブリは、1つまたはいくつかの厳密に関連するライブラリに関連付けられています。たとえば、shlwapi.dllには、shlwapi.libからのすべてのエクスポート機能があります。 kernel32.dllは、kernel32.libとkernelbase.libの両方に対してすべてを備えています。

すべてのアセンブリはNUGETを介して利用可能であり、.NET 4.5、4.8、5.0、6.0、7.0、8.0、.Net Standard 2.0、Core 3.1、およびサポートSourcelinkに対してビルドを提供します。拡張機能は、Winforms、WPF、およびUWPプロジェクトで使用できます。他の.NETバージョンのサポートが必要な場合は、バージョン3.3.15以前をご覧ください。

このプロジェクトは、十分なテスト後数週間ごとに新しいバージョンをリリースします。新しいリリースは、リリースノートとともにリリースセクションでカタログ化され、すべてのNugetパッケージがnuget.orgに公開されています。各githubプッシュは、Appveyorビルドをトリガーします。オーナーは、無料のオープンソースアカウントに感謝します！そのビルドのステータスは、このページのヘッダーにあります。これらのビルドからのNUGETパッケージは、https://ci.appveer.com/nuget/vanara-prereleaseのAppveyorのProject Nugetソースでテスト目的で利用できます。

使用

1. Microsoftドキュメントで必要な関数を探してください。どのライブラリまたはDLL機能があるかに注意してください。
2. Vanaraライブラリが存在することを確認し、下のサポートされているライブラリテーブルを見て機能を備えています。アセンブリリンクをクリックすると、そのアセンブリのカバレッジのドリルダウンに移動します。あなたの関数を見つけて、一致する実装がある場合、それは右に表示されます。 GitHubのプロジェクト検索（ページの左上）を使用して、機能、方法、または定数を検索することもできます。必ず「このリポジトリで」を選択してください。
3. Nugetを介してプロジェクトにアセンブリを追加します。
4. 関数を使用するには、次のことができます。
   1. 直接var bret = Vanara.PInvoke.Kernel32.GetComputerName(sb, ref sbSz);
   2. C＃6.0以下以下で、ディレクティブを使用して静的を使用して電話します。

    using static Vanara.PInvoke.Kernel32;
   
   var bret = GetComputerName(sb, ref sbSz);
   

5. 場合によっては、特にセキュリティ、システムサービス、フォーム、シェルのために、サポートアセンブリの1つに対応するヘルパー/ラッパークラスがあります。ライブラリページ（セクションのリンクをクリック）に移動し、各ライブラリに含まれるクラスをご覧ください。

デザインの概念

• 単一のDLLからインポートされるすべての関数は、DLLにちなんで命名された単一のアセンブリに配置する必要があります。
  • （例：Assembly Vanara.PInvoke.Gdi32.dll 、システムディレクトリのgdi32.dllからエクスポートされる列挙、定数、構造をすべての機能とサポートする列挙、構造をサポートします。）
• 多くのライブラリが使用する構造またはマクロまたは列挙（機能なし）は、 Vanara.CoreまたはVanara.PInvoke.Sharedに入れられます。
  • （たとえば、マクロのHIWORDと構造SIZEどちらもVanara.PInvoke.Sharedとクラスにあり、インタードコールを簡素化し、ネイティブメモリ管理はVanara.Coreにあります。）
• プロジェクト内で、すべてのコンストラクトは、Windows APIで定義されているヘッダーファイル（*.h）にちなんで名前が付けられたファイルに含まれています。
  • （例えば、 Vanara.PInvoke.Kernel32プロジェクトディレクトリには、それぞれfileapi.cs、fileapi.h、winbase.h、winnt.hを表すwinbase.cs、winnt.csファイルがあります。）
• 構造または関数の直接的な解釈がメモリの漏れや誤用につながる場合、私はその使用を簡素化しようとしました。
• 構造が常に参照によって渡され、その構造がメモリの割り当てをクリーンアップする必要がある場合、構造をIDisposableするクラスに変更しました。
• 可能な限り、すべてのハンドルは、Windows APIハンドルにちなんで名付けられたSafeHandleデリバティブに変わりました。これらのハンドルが関数への呼び出しが必要な場合、リリース/閉鎖/破壊する必要がある場合、その機能を廃棄時に実行する派生したSafeHANDLEが存在します。
  • 例えば、 HTOKENが定義されています。 SafeHTOKEN 、 CloseHandleを呼び出す自動リリースでそのハンドルの上に構築されます。
• 可能な限り、発信者によって解放されるメモリを割り当てるすべての機能は、安全なメモリハンドルを使用します。
• すべてのPinvoke Callsは、 Vanara.PInvokeが付けたアセンブリにあります。
• 構造が定数として関数に渡される場合、その構造は、 refキーワードを必要とせずに参照によって構造を渡すinを使用してマーシャリングされます。
  • Windows API： BOOL MapDialogRect(HWND hDlg, LPRECT lpRect)
  • vanara： bool MapDialogRect(HWND hDlg, in RECT lpRect);
• Pinvoke呼び出しを使用するクラスまたは拡張機能がある場合、それらはVanaraが付けたラッパーアセンブリにあり、その後、機能の論理名が続きます。今日、それらはコア、セキュリティ、システムサービス、windows.forms、windows.shellです。

サポートされているライブラリ

ライブラリ/DLL	組み立て	カバレッジ	ヌゲットリンク
aclui.dll	vanara.pinvoke.aclui
Activeds.dll	vanara.pinvoke.activeds
advapi32.dll、secur32.dll、authz.dll、sspicli.dll、schannel.dll、tdh.dll	vanara.pinvoke.security
amsi.dll	vanara.pinvoke.amsi
avicap32.dll、avifil32.dll、msacm32.dll、msvfw32.dll、winmm.dll	vanara.pinvoke.multimedia
avrt.dll	vanara.pinvoke.avrt
Cabinet.dll	vanara.pinvoke.cabinet
cfgmgr32.dll	vanara.pinvoke.cfgmgr32
cimfs.dll	vanara.pinvoke.cimfs
cldapi.dll	vanara.pinvoke.cldapi
clfsw32.dll	vanara.pinvoke.clfsw32
comctl32.dll	vanara.pinvoke.comctl32
comdlg32.dll	vanara.pinvoke.comdlg32
credui.dll	vanara.pinvoke.credui
crypt32.dll、bcrypt.dll、ncrypt.dll、tokenbinding.dll、cryptui.dll、cryptnet.dll、cryptdlg.dll	vanara.pinvoke.cryptography
d2d1.dll	vanara.pinvoke.direct2d
d3d11.dll、d3dcsx.dll、d3d11sdklayers.dll	vanara.pinvoke.direct3d11
d3d12.dll	vanara.pinvoke.direct3d12
d3dcompiler_47.dll	vanara.pinvoke.d3dcompiler
davclnt.dll	vanara.pinvoke.davclnt
dbghelp.dll、ImageHlp.dll	vanara.pinvoke.dbghelp
dhcpcsvc6.dll、dhcpcsvc.dll	vanara.pinvoke.dhcp
dnsapi.dll	vanara.pinvoke.dnsapi
dosvc.dll	vanara.pinvoke.dosvc
drt.dll、drtprov.dll、drttransport.dll	vanara.pinvoke.drt
dstorage.dll	vanara.pinvoke.dstorage
dwmapi.dll	vanara.pinvoke.dwmapi
dwrite.dll	vanara.pinvoke.dwrite
dxcore.dll	vanara.pinvoke.dxcore
dxgi.dll	vanara.pinvoke.dxgi
ehstorapi.dll	vanara.pinvoke.enhancedstorage
elscore.dll	vanara.pinvoke.elscore
fhsvcctl.dll	vanara.pinvoke.fhsvcctl
firewallapi.dll	vanara.pinvoke.firewallapi
fundisc.dll	vanara.pinvoke.fundisc
fwpuclnt.dll	vanara.pinvoke.fwpuclnt
gdi32.dll	vanara.pinvoke.gdi32
httpapi.dll	vanara.pinvoke.httpapi
imapi2.dll、imapi2fs.dll	vanara.pinvoke.imapi
Imm32.dll	vanara.pinvoke.imm32
iphlpapi.dll	vanara.pinvoke.iphlpapi
iscsidsc.dll	vanara.pinvoke.iscsidsc
kernel32.dll、kernelbase.dll、normaliz.dll、vertdll.dll	vanara.pinvoke.kernel32
KTMW32.dll	vanara.pinvoke.ktmw32
LZ32.dll	vanara.pinvoke.lz32
拡大。Dll	vanara.pinvoke.magnification
mmdevapi.dll	vanara.pinvoke.coreaudio
mpr.dll	vanara.pinvoke.mpr
msctf.dll、input.dll、msimtf.dll	vanara.pinvoke.TextServicesFramework
msftedit.dll、riched20.dll	vanara.pinvoke.msftedit
msi.dll	vanara.pinvoke.msi
msrdc.dll	vanara.pinvoke.msrdc
ndfapi.dll	vanara.pinvoke.ndfapi
netapi32.dll	vanara.pinvoke.netapi32
netprofm.dll	vanara.pinvoke.netlistmgr
newdev.dll	vanara.pinvoke.newdev
ntdll.dll	vanara.pinvoke.ntdll
ntdsapi.dll	vanara.pinvoke.ntdsapi
ODBC32.dll	vanara.pinvoke.odbc32
ole32.dll、oleaut32.dll、propsys.dll	vanara.pinvoke.ole
oleacc.dll	vanara.pinvoke.accessibility
OLEDB.DLL	vanara.pinvoke.oledb
oledlg.dll	vanara.pinvoke.oledlg
opcservices.dll	vanara.pinvoke.opc
p2p.dll	vanara.pinvoke.p2p
pdh.dll	vanara.pinvoke.pdh
peerdist.dll	vanara.pinvoke.peerdist
Photoacq.dll	vanara.pinvoke.photoacquire
poradedeviceapi.dll、porabledeviceconnectapi.dll、portableadevicetypes.dll	vanara.pinvoke.portableadeviceapi
powrprof.dll	vanara.pinvoke.powrprof
Proicedfslib.dll	vanara.pinvoke.projectedfslib
qmgr.dll	vanara.pinvoke.bits
qwave.dll、traff.dll	vanara.pinvoke.qos
rpcrt4.dll	vanara.pinvoke.rpc
rstrtmgr.dll	vanara.pinvoke.rstrtmgr
Searchapi	vanara.pinvoke.searchapi
sensorsapi.dll	vanara.pinvoke.sensorsapi
setupapi.dll	vanara.pinvoke.setupapi
shcore.dll	vanara.pinvoke.shcore
shell32.dll、url.dll	vanara.pinvoke.shell32
shlwapi.dll	vanara.pinvoke.shlwapi
taskschd.dll、mstask.dll	vanara.pinvoke.taskschd
uianimation.dll	vanara.pinvoke.uianimation
uiautomationcore.dll	vanara.pinvoke.uiautomation
urlmon.dll	vanara.pinvoke.urlmon
user32.dll	vanara.pinvoke.user32
userenv.dll	vanara.pinvoke.userenv
usp10.dll	vanara.pinvoke.usp10
uxtheme.dll	vanara.pinvoke.uxtheme
version.dll	vanara.pinvoke.version
virtdisk.dll	vanara.pinvoke.virtdisk
vssapi.dll	vanara.pinvoke.vssapi
wcmapi.dll	vanara.pinvoke.wcmapi
wcnapi.dll	vanara.pinvoke.wcnapi
websocket.dll	vanara.pinvoke.websocket
wer.dll	vanara.pinvoke.wer
winbio.dll	vanara.pinvoke.winbio
winhttp.dll	vanara.pinvoke.winhttp
wininet.dll	vanara.pinvoke.wininet
winscard.dll	vanara.pinvoke.winscard
winspool.drv、prntvpt.dll	vanara.pinvoke.printing
wintrust.dll	vanara.pinvoke.wintrust
wlanapi.dll、wlanui.dll	vanara.pinvoke.wlanapi
WS2_32.dll	vanara.pinvoke.ws2_32
wscapi.dll	vanara.pinvoke.wscapi
wslapi.dll	vanara.pinvoke.wslapi
wsmsvc.dll	vanara.pinvoke.wsmsvc
wtsapi32.dll	vanara.pinvoke.wtsapi32
wuapi.dll	vanara.pinvoke.wuapi

サポートアセンブリ

組み立て	ヌゲットリンク	説明
vanara.bits		Windowsビット（背景インテリジェント転送サービス）機能の完全な.NETカバレッジ。 Windows 11を介してすべてのライブラリ機能へのアクセスを提供し、古いOSバージョンで新機能が利用できない場合、優雅に失敗します。
vanara.core		このライブラリには、ヴァナラアセンブリ全体で使用するための共有方法、構造、定数が含まれています。いくつかの便利な拡張機能を備えたWindows.hと考えてください。それは以下を含みます： 列挙されたタイプ（列挙）、ファイル、および反射を介した方法と特性抽出を操作するための拡張方法 構造の配列と文字列をマーシャリングするための拡張およびヘルパー方法 cotaskmem、hglobal、または梱包と抽出アレイ、構造、生のメモリを処理するローカルコールを介して割り当てられたメモリを使用するためのセーフハンドルベースのクラス メモリ内のオブジェクトの安全なピン留め マーシャルメモリに基づくメモリストリーム
vanara.directoryServices		Win32 ADSメソッドとインターフェイスをめぐるラッパークラスは、Active Directoryおよびその他のディレクトリサービスコールへの簡素化されたオブジェクト指向のアクセスを提供します。
vanara.Management		System.Managementの拡張機能とヘルパークラス。
vanara.net		Win32ネットワーキング関数をめぐる抽象化されたクラスは、DNS、DHCP、フィルタリング、アクセス、発見などの主要なネットワーク機能への簡素化されたオブジェクト指向のアクセスを提供します。
vanara.pinvoke.directx		DirectXからインポートされたPinvoke API（メソッド、インターフェイス、構造、定数）。
vanara.pinvoke.shared		vanara.pinvokeアセンブリ全体で使用するための共有方法、構造、定数。含まれる： コム列挙のためのIENUMERABLE HELPERS Cotaskmemポインター用のカスタムマーシャラー hresult、win32error、ntstatusのエラー結果クラスを拡張します 標準Windows.hマクロ（例：Hiword、Makelongなど） オーバーラップメソッドラッパー リソースIDホルダー 共有構造と酵素（リリースノートを参照）
vanara.pinvoke.spellcheckingapi		WindowsスペルチェックAPIからインポートされたPinvoke API（メソッド、構造、および定数）。
vanara.security		Vanara Pinvoke図書館から派生したセキュリティ関連アイテムのクラス。 Active DirectoryおよびAccess Controlクラスの拡張メソッド、アカウント、UAC、特権、システムアクセス、なりすまし、SIDS、および完全なLSAラッパーの操作方法が含まれます。
vanara.systemservices		Vanara Pinvokeライブラリから派生したシステム関連アイテムのクラス。プロセスの拡張機能（特権と伸び）、FileInfo（圧縮情報）、共有ネットワークドライブとデバイス、およびネイティブAPI呼び出しを介して拡張情報を引き出すServiceController（SetStartType）が含まれます。
vanara.virtualdisk		.netクラスは、virtdisk.dllのp/invoke関数を使用して、Windows Virtual Storage（VHDおよびVHDX）を管理します。
vanara.windows.extensions		Vanara P/Invokeタイプと方法からWindowsフォームの種類と方法への拡張方法と変換。
vanara.windows.forms		Vanara Pinvokeライブラリから派生したユーザーインターフェイス関連アイテムのクラス。 Post Vista機能を提供するためのほぼすべての一般的なコントロールの拡張機能、Winformsコントロール（パネル、コマンドリンク、コンボボックス、iPaddress、スプリットボタン、トラックバーおよびテーマコントロール）、シャットダウン/再起動/ロックコントロール、バッファー塗装、リソースファイル、アクセスコントロールエディター、Windows.Formsのシンプルなデザイナーフレームワーク。
vanara.windows.shell.common		Vanara Pinvokeライブラリから派生したWindowsシェルアイテムの一般的なクラス。シェルアイテム、ファイル、アイコン、リンク、およびタスクバーリストが含まれています。
vanara.windows.shell		Vanara Pinvokeライブラリから派生したWindowsシェルアイテムのクラス。シェルアイテム、ファイル、アイコン、リンク、およびタスクバーリストが含まれています。
vanara.winui.extensions		Vanara P/Invokeタイプと方法からUWPおよびWinUIの種類と方法への拡張方法と変換。
vanara.wpf.extensions		Vanara P/Invokeタイプと方法からWPFの種類とメソッドへの拡張メソッドと変換。

クイックリンク

• ドキュメント
• 問題

サンプルコード

Unitestフォルダーと、Vanaraを使用してC＃のWindowsサンプルを再現するWinclassicsAmplescsプロジェクトには、多くの例があります。