Release Notes - 3.3.10 and 3.3.9

3.3.9

Additions

• Added CfgMgr32 assembly (#222) with initial requested functions
• Added assembly for Text Services Framework
• Added DEVPROPKEY.LookupName and ToString methods
• Added DEVPROPKEY.TryGetReadOnly method to look at read-only flag.
• Added DEVPROPTYPE.GetObject extension methods
• Added GUID_DEVINTERFACE_* constants
• Added LANGID structure
• Added actions to DEVPROPKEY corresponding type info
• Added missing structures from SetupAPI's devpropdef.h.

Fixes

• Extracted and fixed IEnumFromCom
• Fixed #223 due to INPUT alignment problem
• Fixed bug in ExplorerBrowser to avoid releasing a PIDL whose owner is the shell itself (#224)
• Fixed #226 by correcting layout and marshaling for WlanSetFilterList and DOT11_SSID
• Fixed bug in IEnumFromCom single object constructor
• Fixed bug in IntPtr.ToStringEnum method that failed when just the ending null terminator was present.
• Moved LCID to WinNT folder where it belongs and updated with LANGID parts

3.3.10

Additions

• Added Lz32 assembly with all functions from lzexpand.h.
• Added SafeHANDLE.ReleaseOwnership method to extract handle from safe handle so it is not closed on disposal.
• Added constants and conversion methods for enums in the C Run-time Library related to files.
• Added related structures for BITMAPINFO and new SafeBITMAPINFO class to handle various incarnations
• Added partial Multimedia assembly.

Fixes

• BREAKING CHANGES: Worked over functions related to BITMAPINFO adding attributes, creating overloads and changing 'ref' params to 'in' params where immutable. Needed because these functions often could fail due to poor processing of the structure.
• Extracted OFSTRUCT from Kernel32 to Shared and changed fFixedDisk field to bool.
• FIxes and improvements to PInvoke.VirtDisk (some breaking changes) and Vanara.VirtualDisk (chaged Enabled to ResilientChangeTrackingEnabled to avoid confusion).
• Fixed #228 by adjusting field type of Vanara.PInvoke.CryptUI.CRYPTUI_WIZ_IMPORT_SRC_INFO.CRYPTUI_WIZ_IMPORT_SRC_INFO_UNION.pwszFileName to blittable StrPtrUni
• Fixed #230 by changing all import library references from Kernelbase to Psapi for functions defined in psapi.h. This allows the functions to work on all versions of Windows.
• Fixes to Cabinet assembly based on #232 issue and @IllidanS4. Many of which are BREAKING CHANGES.
• Modified structure fields to make blittable
• Support Windows 10 window-frame style (#229)

Release Notes - 3.3.8

Additions

• BREAKING CHANGE: Removed Vanara.Windows.Forms.NavigationLogDirection in leiu of duplicate in Vanara.Windows.Shell
• Updated ComStream to support IStream implementation
• Enhanced ComConnectionPoint
• Added Vanara.PInvoke.IMAPI (Image Mastering API) assembly
• Added Vanara.Windows.Shell.ShellBrowser (#221)
• Added optional parameter overloads for SetFilePointer, SetFilePointerEx
• Added generic Win32Error.ThrowLastErrorIf method
• Added IDeviceContext.MeasureText extension method to overcome deprecation of TextFormatFlags.ModifyString

Fixes

• Fixed a number of interfaces in SearchApi that had properties in wrong order which caused memory access violations

Release Notes - 3.3.7

Fixes

• Use explicit framework reference rather than TFM -windows. (#212). This reduces package sizes by up to 70%. Thanks to @NN--- for identifying problem and providing fix.
• Fixed bug in ReadOnlyPropertyStore.TryGetValue (#219)

Additions

• Cleaned, updated all NtDll parameter attributes and added overloads where required (#220).
• Separated out UNICODE_STRING structures and functions and added a SafeUNICODE_STRING class that abstracts process specific memory access and layout.
• Added marshaler to handle strings replacing UNICODE_STRING
• Added HPROCESS.IsWow64() extension method

Release Notes - 3.3.6

Additions

• Added generic CloseHandle and DuplicateHandle methods to better support IKernelHandle and SafeKernelHandle instances.
• Added parameter attributes to CreateFileMapping variants
• Added Function Discovery API assembly
• Added Windows Connect Now (wcnapi) assembly
• Added many methods to SafeSAFEARRAY to make it more like System.Array and more interoperable.
• Added SAFEARRAY function overloads for simpler parameter passing.
• Added VARTYPE.GetCorrespondingType extension method to convert to a .NET or Vanara type.

Fixes

• Truncated desc for Kernel32 project to avoid 35K char limit
• Fixed bug in LinkedListToIEnum extension method taking offset; now returning 0 for offset ends links.
• Changed return value of OpenFileById from IntPtr to SafeHFILE
• Added equality operators for IHandle and IntPtr to SafeHANDLE.
• Made implicit conversion to HANDLE work from SafeHandle instead of SafeHANDLE
• Changed INVALID_SET_FILE_POINTER a UInt32 to match SetFilePointer output type. Changed unsafe overload of ReadFIle to have all pointer params. Added SetFilePointer overload taking uint values as params.
• Change all IO completion keys to IntPtr instead of UIntPtr -- they need to interchange with HANDLE types almost always.
• Fixed ISearchRoot. IDL has property methods in put/get order instead of get/put and wrapping them in properties does not seem to allow that order.
• Fixed READ_USN_JOURNAL_DATA.FirstUsn type per #215.
• Fixed bug in FreePropVariantArray param definition
• Fixed parameters on a number of SAFEARRAY functions.
• Fixed bug in SAFEARRAYBOUND.ctor.
• Fixed bugs in PROPVARIANT.GetSafeArray and SetSafeArray that caused crashed on all but a few use cases.

Release Notes - 3.3.5

Additions

• Added Vanara.PInvoke.RstrtMgr project/assembly with Restart Manager functions. 100% complete.
• Added over 100 new structures supporting control codes and DeviceIoControl
• Added AnySizeStringMarshaler which is an IVanaraMarshaler implementation to handle structures where the last field is a single character string array.
• Added ability to use "*" as field name to indicate that string or array length should be determined by the amount of allocated memory.
• Added parameter attributes and DeviceIoControl overload that takes no input or output params.
• Added non-opaque SID structure
• Added COMPRESSION_FORMAT enum
• Added/updated tests for Kernel32

Fixes

• Fixed ambiguity with changes to PostQueuedCompletionStatus
• Replaced GetLogicalDriveStrings with overloaded methods not using StringBuilder.
• Usability updates to CldApi functions.
• Fixed path size limitation on EnumFindMethods parameter (#213)

Release Notes - 3.3.3 and 3.3.4

Release 3.3.4

Fixes

• Fixed bug with ShellContextMenu failing when passed the desktop shell item. Took chance to optimize folder params. (#206)
• Fixed bug in ShellItemImages throwing unnecessary error if unable to generate thumbnail
• Fixed bug in ShellItem when calling GetHandler without BHID value
• Fixed issues with BasicMessageWindow that caused creation failures and WndProc call failures.

Additions

• Added IContextCallback, ContextSwitcher and other IIDs. (#209 and #211)
• Added WindowClass to encapsulate information about a window class.
• Improved parameter attributes and overloads for CreateWindowEx and GetClassInfoEx

Release 3.3.3

Fixes

• Fixed disposal bug in BasicMessageWindow
• Fixes to NtQueryInformationProcess to compensate for bitness issues between processes. #123
• Updated project files with ImportWindowsDesktopTargets feature to prevent NETSDK1136 build error (#200)
• Reverted HBITMAP.ToBitmap() extension to just call Image.FromHBITMAP to avoid flipping until addressed (#202)
• Fixed layout problem with MIB_UDP6ROW_OWNER_MODULE (#189)
• Removed all calls to Marshal.ReleaseComObject where there exists a possibility that the interface could have been referenced by another object and changed to nulling the holding variable. See discussion thread #188.

Additions

• Changed Win32Error.GetLastError to use function from Kernel32 instead of Marshal.GetLastError to improve speed.
• Added Macros.MAKEINTATOM function
• Added CreateWindowEx overload taking IntPtr for class name
• Added ability to ShellAssociations from ShellItem and improved readability of exception handlers for ERROR_* conditions
• Converted message window from Control to BasicMessageWindow in ShellContextMenu
• Added SafeMemStruct.InitializeSizeField method to initialize an in-memory structure's size field
• Added UNICODE_STRING.ToString(HPROCESS hProc) method
• Added addition PROCESSINFOCLASS values from ProcessHacker and PInvoke.net
• Added missing ReportIScsiTargetPortals function
• Completed work for WSMan, including enhanced definitions for the IWSMan set of interfaces.
• Added MiniDumpWriteDump and supporting structs #204
• Moved VerRsrc structures and enum to new Version assembly
• Added Vanara.PInvoke.Version project will all functions
• Added MiniDumpWriteDump overload and fixed test (thanks @nn)

Release Notes - 3.3.2

Fixes
Fixed access violation exception in ShellContextMenu when building a MenuItemInfo for separators (#195)

Additions
Finished work and added some helper methods on IScsiDsc
Added more SetupAPI functions
Added InteropExtensions.SizeOf(object) method to calculate the size of an object in native memory. It will handle blittalbe structures, primitives, strings and arrays or enumerable lists of those items.
Added SafeMemStruct.Append overloaded methods to extend memory and write in bytes, memory or objects and return a pointer to the newly written element.
Added SafeMemStruct.GetFieldAddress method to get the location of a field in the structure's memory.

Release Notes - 3.3.1

This is a massive release with tons of additions, fixes and, unfortunately, breaking changes. I try to avoid them, but when stuff breaks and requires fixing, well, code has to change. PLEASE check your dependencies and assumptions with listed changes.

New Assemblies

• Vanara.PInvoke.ComDlg32
• Vanara.PInvoke.IScsiDsc
• Vanara.PInvoke.Msi
• Vanara.PInvoke.NewDev
• Vanara.PInvoke.OleDlg
• Vanara.PInvoke.Rpc
• Vanara.PInvoke.SHCore (#193)
• Vanara.PInvoke.SetupAPI
• Vanara.PInvoke.WTSApi32
• Vanara.PInvoke.WsmSvc (#194)

BREAKING CHANGES

• Changed AppendMenu param from UIntPtr to IntPtr for easier conversion from HMENU and int command ids. Change MENUINFO.dwMenuData to IntPtr for easier conversions.
• Moved IObjectWithSite from Shell32 to Ole32
• Moved RPC enums from Ole32 to Rpc assembly and static class.
• Revamped SendMessage overloads to reduce accidential use of wrong overload. Most uses still work except passing a class in as lParam.
• Changed IDropTarget methods to use MouseButtonState param value instead of uint. Fixed dependencies.
• Changed ThrowLastErrorIfInvalid to a generic method to return the same type as the delegate
• Changed all IContextMenu variants to have PreserveSig model for implementation
• Changed allocated string fields in ComDlg32 to StrPtrAuto rather than String.
• Cleaned and extended Vanara.Security to support ActiveDirectoryExtension on all platforms
• Enhanced ShellContextMenu further to support non-WinForms platforms better. (#178)
• Extended IntPtr.Write(object value...) method to handle almost all cases of object types (arrays, lists, etc.)
• Extended and improved object GetValue(this REG_VALUE_TYPE value) method
• Made serious changes to IOleCommandTarget. It was very broken (#188). Added other missing stuff from docobj.h.
• Moved DEVICE_SCALE_FACTOR from Shell32 to Shared
• Moved HOTKEYF from ComCtrl32 to User32 to align with WM_GETHOTKEY location
• Moved IOleCommand declaration to Ole Ole32 from Shell32
• Moved MouseButtonState from User32 to Shared assembly and up to PInvoke namespace. Fixed dependencies.
• Moved OLE types CY, DECIMAL and DATE up to Shared assembly.
• Moved PDCAP enum from PowrProf to Shared and added a few other enums and structure to Shared.Wdm.cs from that header file.

Fixes

• Fixed structures that could not load due to marshal attribute bugs
• Derived ShellContextMenu from IDisposable so that it correctly disposes the underlying IContextMenu instance. #178
• Fix misspelled path of file Winternl.cs (#187)
• Fixed Int32/UInt32 mismatch on OFN
• Fixed ShellContextMenu build error due to change to AppendMenu
• Fixed alignment issue with MIB_UDPROW_OWNER_MODULE (#189)
• Fixed bug in GetObject overloads
• Fixed bug in LookupAccountSid2 where assigned return values incorrectly.
• Fixed declaration of IEnumAssocHandlers.Next
• Fixed methods in Shell32 (SHGetFolderLocation, SHGetFolderPath, SHGetFolderPathAndSubDir) that should use CSIDL enum but didn't. Fixed dependencies.
• Fixed packing directive on MIB_UDP6ROW_OWNER_MODULE and MIB_UDPROW_OWNER_MODULE per issue #189
• Removed Security.PermissionSetAttribute from all classes, properties and methods. It is now marked Obsolete.
• Removed exception on index == 0 from IndirectResource ctor
• Removed incorrect FlagsAttribute from WindowMessage enum and removed duplicate, unused WM_HSHELL values
• Updated Windows.Shell project to support forms

Additions

• Abstracted out read-only methods from SafeAllocatedMemoryHandle into SafeAllocatedMemoryHandleBase
• Added BITMAPINFO.FromHBITMAP method and default static values for BITMAPINFO and DIBSECTION
• Added BROADCAST_QUERY_DENY return value.
• Added BasicMessageWindow class as a simple alternative to NativeWindow and MessageWindow
• Added BindToHandler overloads accepting BHID enum values
• Added CW_USEDEFAULT constant and fixed return value of CreateWindow function
• Added CorrespondingTypeAttribute to power GUID values when they support a secondary value
• Added CorrespondingTypeAttributes to all BHID enum values
• Added GDI extension methods for HBITMAP - IsBottomUpDIB, IsDIB and simplified ToBitmap
• Added GetVolumePathNamesForVolumeName overload
• Added HWND.HWND_MESSAGE value
• Added IArrayStruct interface to identify two-field structures where the first field is an UInt32 and the second is a pointer to an array of structures along with supporting marshaler and extension method.
• Added IArrayStruct inheritance for DRT_DATA
• Added IDC_ cursor resource id constants
• Added IDI_* values for static icons and overloaded LoadIcon function to accept a ResourceId param.
• Added ISafeMemoryHandle.GetBytes method that was already implemented all implemented classes
• Added LsaQueryCAPs overload taking a pointer for the first param
• Added MADCAP functions to Vanara.PInvoke.Dhcp
• Added Null field to SafeCoTaskMemStruct and SafeCoTaskMemStruct
• Added PlatformTarget value as pre-processor constant for all projects.
• Added ResourceId.IsIntResource property
• Added SafeHBITMAP.ToBitmap method
• Added ShellDataObject constructor taking a list of ShellItems which adds them via CFSTR_SHELLIDLIST
• Added ShellItem.Verbs to get a list of active verbs
• Added ShellItemImages and associated tests to pull images for a shell item from a variety of different interfaces. For some items, the image appears upside down without an DIB indication.
• Added StructHelper.InitWithSize to simplify the many structures that have to be initialized with their size.
• Added VOLUME_DISK_EXTENTS
• Added Vanara.Collections.ICOMEnum interface to indicate COM interfaces that support the Enum/Reset pattern. Useful for simplifying getting IEnumerable runs from them. Added ICOMEnum interface to all appropriate COM interfaces.
• Added Vanara.Diagnostics.DeviceManager and supporting classes to manage devices and device classes on local or remote machines.
• Added LookupAccountSidLocal per #184 comment.
• Added PropertyDescriptionList.GetValuesForShellItem method to retrieve list of properties from a shell item. Useful for tooltips and like items retrieved from ShellAssociation.
• Added ShellItem.ContextMenu and Images properties, enhanced GetHandler method to check for correct interfaces, changed InvokeVerb to use ShellContextMenu
• Added abstract SystemEventHandler which provides a smart message window that will automatically spin up a thread, if needed, for the message pump. Converted ShellItemChangeWatcher from using NativeWindow to using SystemEventHandler to support console use
• Added access to handlers for ShellAssociation #181
• Added binary negate overload to BOOL and BOOLEAN
• Added check for empty icon file in LoadImageFromExtractImage
• Added constants for static controls (msgs, notifications and styles)
• Added constructor for MSG struct
• Added conversion methods from HBITMAP to Bitmap and BitmapSource
• Added conversion methods from HICON to HBITMAP and BitmapSource.
• Added explicit conversion from SOCKADDR_STORAGE to SOCKADDR_IN and SOCKADDR_IN6
• Added missing ASSOCSTR values (#180)
• Added new SendMessage overload for WM_GETTEXT use case (#191).
• Added over 100 new COM interfaces to Ole32
• Added owner-draw structures and enum to User32.
• Added param attributes for CreateWindow(Ex) and CREATESTRUCT structure
• Based on Windows error in LookupAccountSid, I've added LookupAccountSid2 based on LsaLookupSid2.
• To Shell32.ShellUtil, added SHIL to pixel conversions and wrapper methods to handle getting images and icons from shell items and folders.
• Finished work on PowerManager event additions for all power events. (#190)

Release Notes - 3.3.0

* New support for .NET 5.0 in all assemblies

Additions

• Added SHChangeNotify overloads for strings and PIDLs
• Added time_t class with conversion support to/from DateTime
• Added HEVENT handle
• Added DHCP client APIs in new Dhcp assembly

Fixes

• Fixed bug in ShellContextMenu.Invoke (#177)

Release Notes - 3.2.21

Added

• Added SafeNativeListBase which is a SafeMemoryHandle that acts as a read-only list and derived SafeNativeLinkedList from it and added ability to change way linked list is retrieved.
• Added InitVariantFromStrRet
• Added IntPtr.AsRef extension method
• Added RefEnumerator.Count, Reset and indexer
• Added InteropExtensions.UnsafePtrToArray method
• Added OLE types CY, DATE, UDATE and DECIMAL
• Added missing VarXX functions from OleAuto32
• Added VariantToStrRet function

Fixed

• Changed GetLogicalProcessorInformationEx helper method to return a safe handle rather than an array so that the memory of linked, nested child arrays is not disposed before use. (#176)