Release Notes - 3.2.20

Additions

• Added PIDL conversion to byte[]
• Added PropertyDescriptor.TryCreate method and CanGroupBy and IsViewable properties
• Updated Theraot NuGet pkg to 3.2.0 across solution
• Added FileIconInit method and SHSTOCKICONINFO.Default field.
• Added GetSystemIcon overload that uses an index and optimized methods.
• Added Vanara.Windows.Shell.StockIcon class
• Added second IExtractIcon.Extract extension to handle getting one icon
• Exposed underlying handle of StockIcon via IconHandle
• Added Vanara.Windows.Shell.ShellDataTable which is a DataTable that defines its columns and row from items in a shell folder. Designed for streamlined async reading of a shell folder's items and their properties.
• Overloaded IntPtr.LinkedListToEnum extension method to allow for offset func.
• Added IGraphicsObjectHandle to all appropriate GDI safe handles
• Added GetUIObjectOf extension methods that return HRESULT
• Added missing param attributes to CopyImage
• Added methods to convert between SHIL values and the system's closest pixel size

Fixes

• Fixed layout of PARTITION_INFORMATION_GPT so it is blittable (#173)
• Optimized PROPERTYKEY.Equals
• Rebased PIDL on SafeHANDLE from GenericSafeHandle to avoid generics.
• Fixed params on IShellFolder2.GetDetailsEx
• Removed unnecessary handling of 'shell::' prefixed paths in GetShellItemForPath. Determined that SHCreateItemFromParsingName already does this.
• Updated parameter attributes and overloads for Shell_GetCachedImageIndex and SHMapPIDLToSystemImageListIndex
• BREAKING CHANGES: Changed name of IExtractIcon to IExtractIconW and added IExtractIconA. In use, both are required. Changed Extract method to unsafe and made parameters pointers to allow for null values. Added Extract extension method for safe access to method.
• MANY BREAKING CHANGES: Since these all can implemented interfaces, changed all interfaces methods to PreserveSig with HRESULT return values for ICategorizer, ICategoryProvider, IObjectWithFolderEnumMode, IShellFolder, IShellFolder2, and IShellIcon. Updated extension methods accordingly.
• Fixed minor bug in IconExtension.GetSystemIcon
• Fixed #175 per detail for GetLogicalProcessorInformationEx
• Moved pure extensions for Gdi functions to Gdi32
• Changed IExtractImage interface to PreserveSig format
• Changed IThumbnailProvider.GetThumbnail to return a SafeHBITMAP instead of HBITMAP
• Fixed ShellNavigationHistory so events fire
• Unchanged non-errant IpHlpLib fields base to FILETIME from SYSTEMTIME per #154 and updated documentation

Release Notes - 3.2.19

Let's just call this release Friday Fixes. Almost all these are bugs turned up after re-running a bunch of the tests

• Changed all methods that returned SafeCoTaskMemString to string. After much reading and testing I determined this was redundant with marshaling code in .NET.
• Fixed bug with CorrespondingTypeAttribute.GetAttrForEnum with default action
• Fixed bugs in PROPVARIANT get value operations
• Fixed bug in PropVariantToStringVector overload
• Added GetPropertyDescriptionList default prop value to get all properties.
• Made BindContext.EnumObjectParam return empty enumeration if method fails
• Fixed bug in IndirectResource.ctor
• Fixed bug in lookup table for WIA_PROPID_TO_NAME
• Fixed bug in PropVariantToStringVector
• Fixed a number of bugs with IUri and IUriBuilder

Release Notes - 3.2.18

Additions

• Added missing constants and macros related to SID size.
• Added SafePSID.FromToken and PSID.GetDomainSid methods
• Added SafeDRT_DATA to DRT
• Added Null fields to SafeHCRYPTHASH, SafeHCRYPTPROV and SafePCCERT_CONTEXT
• Added missing Crypt32 constants
• Added CERT_RDN_ATTR and CRYPT_BIT_BLOB
• Added predefined values to SafeOID
• Added methods to assist with memory alignment.
• Added NativeMemoryStream.ReadToPtr and WriteFromPtr methods to interact with allocated memory.
• Added methods to convert from IN_ADDR to IN6_ADDR
• Added SIZEOF_SOCKET_ADDRESS_LIST macro.
• Extended SOCKADDR explicit cast to SOCKADDR_IN6 so that if represented by a v4 IP address, it will convert it to IPV6 before casting.
• Added LsaOpenPolicy test for remote machine (#169)
• Added DISPID constants to ShlDisp and updated dependent interfaces
• Added overload for ConnectToConnectionPoint for optional last param and fixed attributes.
• Added missing EnumeratorToEnumVariantMarshaler for .NET Core
• Initial implementation of FirewallApi.dll. Yes, it is in VB instaead of C#. Ony VB support parameterized properties and the underlying COM objects have these. Plus, it was a fun experiment.
• Added Vanara.Collections.History class
• Added standard HWND constants as static fields in HWND
• Added PID constants for property ID values in a PROPERTYKEY
• Added explicit ReadConsoleA and WriteConsoleA for UTF-8 operations (#171)
• Added IsUserCetAvailableInEnvironment and SetProcessDynamicEHContinuationTargets functions to Kernel32
• Added Get*Profile** function overloads to replace StringBuilder with allocated memory for multistring results (#172)
• Added Vanara.Configuration.InitializationFile wrapper class for all PrivateProfile functions.
• Added equality operators to PIDL
• Added shell::: URI handling to ShellUtil.GetShellItemForPath
• For ShellItem, added TypeConverter for strings, DataObject property, multiple Open method overloads, and ToUri method.

Fixes

• BREAKING CHANGE: Modified interfaces IOleWindow and IShellBrowser and all derived interfaces so they use PreserveSigAttribute. All these interfaces can be client implemented and needed that capability.
• BREAKING CHANGE: Fixed return value of TrackPopupMenuEx so command identifiers could be returned.
• BREAKING CHANGE: Reconfigured PROPSPEC structure so it works on both X86 and X64 and added constructors to help.
• BREAKING CHANGES: Fixed all the profile functions for ease of use and proper function.
• Fixed signature on CryptSignAndEncodeCertificate and CryptSignCertificate and added Null field on SafeHCRYPTKEY
• Fixed field types in CERT_INFO and CERT_PUBLIC_KEY_INFO
• Addressed #168 by adding protected virtual GetDialogFlags and GetPreVistaDialogFlags methods that return the flags used by SDK functions.
• Changed SOCKET_ADDRESS_LIST[] references to IntPtr or void**.
• Fixed condition in HRESULT.FormatMessage that fails when MUI file couldn't be found.
• Fixed bug in marshaler for LSA_UNICODE_STRING under X64 that caused alignment error and failure on all calls. Thanks @ryannewington for identifying the problem and where to fix it (#169).
• Fixed attributes on IShellView.GetItemObject
• Fixed bug in IContextMenu3.HandleMenuMsg2 declaration
• Fixed bug in IPropertySetStorage::Create definition …
• Fixed problems with IPropertyStorage::Read/WriteMultiple definitions and provided overload to simplify. Fixed param on Commit method.

Release Notes - 3.2.16

Additions

• Added DRT and PeerDist libraries
• Added Vanara.Network.InternetProxyOptions to manage proxy settings for an internet session or for the system.
• Added new property keys for Recycle Bin (#162)
• Added missing FOLDERID items (#164)
• Adding missing enums PER_CONN_AUTODISCOVERY_FLAGS and PER_CONN_FLAGS

Fixes

• BREAKING CHANGES Changed function of IndirectResource so that it accepts a string and then provides read-only properties of the parts rather than other way around. Too fragile. Also fixed ResourceId property so that it is an Int32 and not a pointer. Wrong impl.
• Fixed error in ReadOnlyPropertyStore.TryGetValue that only would return true (#163)
• Fixed bug in ShellFileOperations when supplying multiple files at once causing an endless loop
• Removed BITS and VirtualDisk project references from SystemServices
• Renamed WIndows.Forms to Windows.Forms (#165)
• Corrected FOLDERTYPEID ControlPanelCategory (#166)

Release Notes - 3.2.15

Additions

• Initial implementation of P2P.dll
• Added NetworkDeviceConnections to Computer class to manage connection to remote shares and printers. Same functionality as command line 'net use'.

Fixes

• Fixed NullReferenceException for WindowsIdentity to WindowsImpersonatedIdentity
• Fixed incorrect parameters being passed to NetDfsSetClientInfo and NetDfsSetInfo
• Fixed bug in WindowsIdentity.Run extension method causing method to be called twice if identity was null
• Added parameter attributes and Win32Error.WNetThrowIfFailed extension method and assoc exception
• For WNetEnumResources helper method, added better error handling, set initial buffer to page size, and fixed bug in loop
• Fixed #158 with errors with IServiceProvider definition causing faults in ExplorerBrowser
• Added DangerousGetInterface() method to expose the underlying IExplorerBrowser interface. Use with caution. #159
• Call to closeMethod in GenericSafeHandle. (#161, #160)

Release Notes - 3.2.14

Additions
Completed initial work on DbgHelp library that also includes ImageHlp.dll functions
Completed initial work for Magnification.dll
Added LoadCursor overload with ResourceId param
Added class StandardCursor with values IDC_xx for LoadCursor
Added CreateWindow "macro".
Added overloads for DialogBox and DialogBoxParam that take ResourceId params instead of strings.
Added LibHelper class with Is64BitProcess and DoesWin32MethodExist methods
Added User32 EnumChildWindows and GetChildWindow methods
Enhanced AttributedControlDesigner to allow for event filtering.
Added ShellFolder.IShellFolder property to expose underlying COM interface
Added IntPtr SendMessage<TEnum, TWP>(HWND hWnd, TEnum msg, TWP wParam, IntPtr lParam = default)

Fixes
BREAKING CHANGE: Corrected GetClientRect to have 'out rect' param rather than by ref.
BREAKING CHANGE: Corrected invalid WindowStyles.WS_SIZEFRAME changing to WS_THICKFRAME
Changed errant IpHlpLib fields from FILETIME to SYSTEMTIME per #154
Added missing WindowStyles values
Changed WIN_CERTIFICATE.bCertificate from IntPtr to byte
Changed RedirectedDesignerPropertyAttribute to RedirectedDesignerItemAttribute so it could be applied to events and methods.
Addressed #155 by adding GetMonitorInfo overload that accepts MONITORINFOEX
Lots of fixes for ShellNamespaceTreeControl (#153). Still not perfect (keyboard movement could be improved), but much better.
Fixed ShellFileOperations throws an exception during the process of moving lnk files (#156)

Release Notes - 3.2.13

Additions

• Added missing XXPseudoConsole functions from consoleapi.h
• Added ShellFileOperations.AnyOperationAborted and OwnerWindow properties.
• Added ShellFileOperationDialog with tests a property ShellFileOperations.CustomProgressDialog to receive an instance of that dialog.
• Completed work on BindContext which wraps IBindCtx
• Added support for ShellItemPropertyStore to be created with a PROPERTYKEY filter or an ICreateObject
• Added missing structures (BCRYPT_OID_LIST, BCRYPT_MULTI_OBJECT_LENGTH_STRUCT, BCRYPT_KEY_LENGTHS_STRUCT) associated with BCrypt.PropertyName
• Added AssociateStringAttribute to associate a string with a code element.
• Added IShellFolder.GetUIObjectOf<T> extension method overload to accept IntPtr[]
• Added ShellItem.InvokeVerb method and test
• Added more well-known Clipboard format strings to ShellClipboardFormat
• Extended all MarshalToPtr methods with lock and unlock pointer functions and optional parameters.
• Made SafeAllocatedMemoryHandle.GetBytes() public
• Added FILEDESCRIPTOR.nFileSize property to combine high/low fields
• Added improved registry key closing to registration classes
• Added Vanara.Windows.Shell.NativeClipboard to expose native clipboard functions that are not routed through COM and DataObject.

Fixes

• Changed CreatePseudoConsole HANDLE params to HFILE after some research. The function will take HFILE and HPIPE instances.
• BREAKING CHANGE: Changed return values of all methods in IFileOperationProgressSink to HRESULT since this is a user implemented interface.
• BREAKING CHANGE: Due to performance, changed IMemoryMethods and ISimpleMemoryMethods to contain method signatures instead of properties of method delegates. Then changed all derived memory classes to new interface definition. I believe most of this only affects internal classes so hopefully not a huge effect on your code.
• Fixed (#152) bug in base class SafeMemoryHandleExt that caused ToString(int...) to fail if memory size was not specifically set (like in parameter assignment).
• Fixed ShellNamespaceTreeControl.SelectedItem designer error

Release Notes - 3.2.12

Additions

• Added ShellFolder.BindToObject and BindToStorage methods
• Added support for drag/drop to ShellNamespaceTreeControl
• Add zero copy GetIpNetTable2.

Fixes

• Corrected #144 by replacing LPStr marshaled string field lpVerb and making it a ResourceId type.
• Fixed bug in UntypedNativeMemoryEnumerator where enumerated type was not set.
• Optimized parameter enumerations and fixed bug in ShellFileOperation.UpdateProgress event (#146)
• For all COM IEnumXX interfaces, fixed the Next method's array parameter so that it references the size on input, not output. This prevents a bug when implementing these interfaces. Thanks to @wangfu91 for finding this and submitting #143.
• Changed compiler option on IEnumNextworkXX interfaces and array parameter on Next methods along with unit test.
• Fixed enumeration failures with EnumServiceStatus, EnumServiceStatusEx and EnumDependentServices (#145)

Release Notes - 3.2.11

Additions

• New Win10 2004 functions
• String methods to ShellFileOperations
• KnownFolderIdExt.GetIShellFolder method
• Missing FILEOP_FLAGS values
• Missing CoClass values for IShellFolder
• Vanara.Windows.Shell.RecycleBin class
• More BHID mappings for ShellItem.GetHandler calls.
• FileInUseHandler to wrap functionality of IFileIsInUse interface for a single file.

Fixes

• Methods and structures that reference DNS_QUERY_OPTION

Release Notes - 3.2.10

Additions

• Added interfaces from comcat.h to Ole32 lib
• Added all remaining shobjidl_core.h interfaces to Shell32 and SearchApi
• Added WallpaperManager to Vanara.Windows.Shell to manage wallpapers.

Fixes

• Fixed bug in COLORREF when setting from a Color.
• Corrected IShellDispatchX.NameSpace method parameter (#131)