Added ControlPanel class to Shell assembly

UnitTests/Shell/ControlPanelTests.cs

@@ -0,0 +1,18 @@
+using NUnit.Framework;
+using static Vanara.PInvoke.Shell32;
+
+namespace Vanara.Windows.Shell.Tests
+{
+	[TestFixture]
+	public class ControlPanelTests
+	{
+		[Test]
+		public void ControlPanelOpenTest()
+		{
+			Assert.That(() => ControlPanel.Open(ControlPanelItem.BitLockerDriveEncryption), Throws.Nothing);
+			Assert.That(() => ControlPanel.Open((ControlPanelItem)0xFFFF), Throws.Exception);
+			Assert.That(() => ControlPanel.Open(ControlPanelItem.DefaultPrograms, "pageFileAssoc"), Throws.Nothing);
+			Assert.That(() => ControlPanel.Open(ControlPanelItem.DefaultPrograms, "XX"), Throws.Exception);
+		}
+	}
+}

UnitTests/UnitTests.csproj

@@ -115,6 +115,7 @@
     <Compile Include="PInvoke\WinInet\WinInetTests.cs" />
     <Compile Include="Properties\AssemblyInfo.cs" />
     <Compile Include="Security\AccessControl\SystemSecurityTests.cs" />
+    <Compile Include="Shell\ControlPanelTests.cs" />
     <Compile Include="Shell\ShellItemTests.cs" />
     <Compile Include="Shell\ShellFolderTests.cs" />
     <Compile Include="Shell\ShellItemPropStoreTests.cs" />

Windows.Shell/ControlPanel.cs

@@ -0,0 +1,66 @@
+using System;
+using System.Runtime.InteropServices;
+using Vanara.Extensions;
+using static Vanara.PInvoke.Shell32;
+
+namespace Vanara.Windows.Shell
+{
+	/// <summary>Provides a means to open Control Panel items and get their paths.</summary>
+	public static class ControlPanel
+	{
+		private static SafeCP cp;
+
+		private static IOpenControlPanel CP => cp != null ? cp.icp : (cp = new SafeCP()).icp;
+
+		/// <summary>Gets the path of a Control Panel item.</summary>
+		/// <param name="item">The Control Panel item.</param>
+		/// <returns>The path.</returns>
+		public static string GetPath(ControlPanelItem item) => GetPath(item.CanonicalName());
+
+		/// <summary>Gets the path of a Control Panel GUID.</summary>
+		/// <param name="item">The Control Panel GUID.</param>
+		/// <returns>The path.</returns>
+		public static string GetPath(Guid item) => GetPath(item.ToString());
+
+		/// <summary>Opens the specified Control Panel item.</summary>
+		/// <param name="item">The Control Panel item.</param>
+		/// <param name="page">Optional. The Control Panel page.</param>
+		/// <exception cref="ArgumentOutOfRangeException">page</exception>
+		public static void Open(ControlPanelItem item, string page = null)
+		{
+			if (page != null && Array.IndexOf(item.ValidPages(), page) == -1) throw new ArgumentOutOfRangeException(nameof(page));
+			// TODO: handle minOsVer gracefully
+			CP.Open(item.CanonicalName(), page, null);
+		}
+
+		private static string GetPath(string item)
+		{
+			var sb = new System.Text.StringBuilder(1024);
+			CP.GetPath(item, sb, (uint)sb.Capacity);
+			return sb.ToString();
+		}
+
+		private class SafeCP : IDisposable
+		{
+			internal readonly IOpenControlPanel icp;
+			private bool disposedValue = false;
+
+			public SafeCP() { icp = new IOpenControlPanel(); }
+
+			~SafeCP() { Dispose(false); }
+
+			public void Dispose()
+			{
+				Dispose(true);
+				GC.SuppressFinalize(this);
+			}
+
+			protected virtual void Dispose(bool disposing)
+			{
+				if (disposedValue) return;
+				Marshal.ReleaseComObject(icp);
+				disposedValue = true;
+			}
+		}
+	}
+}