Add initial Appx/Msix support, starting with preprovisioning.

This is done using a combination of WinRT and COM, using all publicly available APIs. The APIs used in the Dism PowerShell module are non-public and therefore avoided while there's a supported mechanism.

Author: mjr4077au

.github/copilot-instructions.md

@@ -55,3 +55,8 @@ The main build dependency is a current .NET SDK. Visual Studio is recommended fo
 - `PSADT.Interop` contains Win32 interop and CsWin32-generated symbols.
 - `PSADT` contains core C# utilities.
 - `PSAppDeployToolkit` contains PowerShell-facing C# types.
+
+## API Usage Guidelines
+
+- Expect accurate, well-researched answers about Windows APIs and COM interfaces. Do not fabricate API names or suggest hacky workarounds when proper documented APIs exist (e.g., Appx COM interfaces for reading package identity).
+- Acknowledge uncertainty rather than inventing answers.

src/PSADT/PSADT.Interop/APPX_PACKAGE_ARCHITECTURE.cs

@@ -0,0 +1,34 @@
+namespace PSADT.Interop
+{
+    /// <summary>
+    /// Specifies the processor architectures supported by a package.
+    /// </summary>
+    [System.Diagnostics.CodeAnalysis.SuppressMessage("Naming", "CA1712:Do not prefix enum values with type name", Justification = "This is how it's named in the Win32 API.")]
+    public enum APPX_PACKAGE_ARCHITECTURE
+    {
+        /// <summary>
+        /// The x86 processor architecture.
+        /// </summary>
+        APPX_PACKAGE_ARCHITECTURE_X86 = Windows.Win32.Storage.Packaging.Appx.APPX_PACKAGE_ARCHITECTURE.APPX_PACKAGE_ARCHITECTURE_X86,
+
+        /// <summary>
+        /// The ARM processor architecture.
+        /// </summary>
+        APPX_PACKAGE_ARCHITECTURE_ARM = Windows.Win32.Storage.Packaging.Appx.APPX_PACKAGE_ARCHITECTURE.APPX_PACKAGE_ARCHITECTURE_ARM,
+
+        /// <summary>
+        /// The x64 processor architecture.
+        /// </summary>
+        APPX_PACKAGE_ARCHITECTURE_X64 = Windows.Win32.Storage.Packaging.Appx.APPX_PACKAGE_ARCHITECTURE.APPX_PACKAGE_ARCHITECTURE_X64,
+
+        /// <summary>
+        /// Any processor architecture.
+        /// </summary>
+        APPX_PACKAGE_ARCHITECTURE_NEUTRAL = Windows.Win32.Storage.Packaging.Appx.APPX_PACKAGE_ARCHITECTURE.APPX_PACKAGE_ARCHITECTURE_NEUTRAL,
+
+        /// <summary>
+        /// The 64-bit ARM processor architecture.
+        /// </summary>
+        APPX_PACKAGE_ARCHITECTURE_ARM64 = Windows.Win32.Storage.Packaging.Appx.APPX_PACKAGE_ARCHITECTURE.APPX_PACKAGE_ARCHITECTURE_ARM64,
+    }
+}

src/PSADT/PSADT.Interop/NativeMethods.cs

@@ -4315,6 +4315,23 @@ internal static HRESULT CoCreateInstance<T>(in Guid rclsid, CLSCTX dwClsContext,
             return res != HRESULT.S_OK ? throw ExceptionUtilities.GetException(res) : res;
         }
 
+        /// <summary>
+        /// Creates and initializes a stream object that is associated with a specified file. The stream object can be used
+        /// to read from or write to the file.
+        /// </summary>
+        /// <param name="pszFile">The path of the file to be associated with the stream object.</param>
+        /// <param name="grfMode">The access mode for the stream object.</param>
+        /// <param name="dwAttributes">The file attributes for the file.</param>
+        /// <param name="fCreate">Indicates whether to create the file if it does not exist.</param>
+        /// <param name="pstmTemplate">A pointer to an existing stream object to be used as a template.</param>
+        /// <param name="ppstm">When this method returns, contains the interface pointer to the stream object.</param>
+        /// <returns>An HRESULT value indicating the success or failure of the operation.</returns>
+        internal static HRESULT SHCreateStreamOnFileEx(string pszFile, STGM grfMode, FileAttributes dwAttributes, BOOL fCreate, [Optional] IStream? pstmTemplate, out IStream ppstm)
+        {
+            HRESULT res = PInvoke.SHCreateStreamOnFileEx(pszFile.ThrowIfFileDoesNotExist(), (uint)grfMode, (uint)dwAttributes, fCreate, pstmTemplate, out ppstm);
+            return res != HRESULT.S_OK ? throw ExceptionUtilities.GetException(res) : res;
+        }
+
         /// <summary>
         /// Lookup table for system information class struct sizes.
         /// </summary>

src/PSADT/PSADT.Interop/NativeMethods.txt

@@ -2,6 +2,8 @@
 AdjustTokenPrivileges
 APPLICATION_USER_MODEL_ID_MAX_LENGTH
 APPLICATION_USER_MODEL_ID_MIN_LENGTH
+AppxBundleFactory
+AppxFactory
 AssignProcessToJobObject
 AttachThreadInput
 AUTHZ_COMPUTE_PRIVILEGES
@@ -107,6 +109,13 @@ HTTRANSPARENT
 HTVSCROLL
 HTZOOM
 HWND_BROADCAST
+IAppxBundleFactory
+IAppxBundleManifestReader
+IAppxBundleReader
+IAppxFactory
+IAppxManifestPackageId
+IAppxManifestReader
+IAppxPackageReader
 IAudioSessionManager2
 IDWriteFactory
 IExecAction
@@ -121,8 +130,8 @@ IMAGE_RESOURCE_DATA_IS_DIRECTORY
 IMAGE_RESOURCE_DIRECTORY
 IMAGE_RESOURCE_DIRECTORY_ENTRY
 IMMDeviceEnumerator
-INFOTIPSIZE
 INFINITE
+INFOTIPSIZE
 InitializeAcl
 InitializeProcThreadAttributeList
 INVALID_FILE_ATTRIBUTES
@@ -284,8 +293,6 @@ POLICY_VIEW_AUDIT_INFORMATION
 POLICY_VIEW_LOCAL_INFORMATION
 POOL_TYPE
 PostQueuedCompletionStatus
-PROPERTYKEY
-PropVariantClear
 PROC_THREAD_ATTRIBUTE_ADDITIVE
 PROC_THREAD_ATTRIBUTE_ALL_APPLICATION_PACKAGES_POLICY
 PROC_THREAD_ATTRIBUTE_CHILD_PROCESS_POLICY
@@ -314,6 +321,8 @@ PROCESS_ACCESS_RIGHTS
 PROCESS_BASIC_INFORMATION
 PROCESS_INFORMATION
 ProcessIdToSessionId
+PROPERTYKEY
+PropVariantClear
 PUBLIC_OBJECT_BASIC_INFORMATION
 QueryDosDevice
 QueryFullProcessImageName
@@ -424,6 +433,7 @@ SetNamedSecurityInfo
 SetSecurityInfo
 SetTokenInformation
 SHChangeNotify
+SHCreateStreamOnFileEx
 SHELL_LINK_DATA_FLAGS
 ShellLink
 SHGetImageList
@@ -435,18 +445,17 @@ SHIL_JUMBO
 SHIL_LARGE
 SHIL_LAST
 SHIL_SMALL
-SLGP_FLAGS
 SHIL_SYSSMALL
 ShowWindow
 SHQueryUserNotificationState
 SHSTOCKICONID
+SLGP_FLAGS
 SLR_FLAGS
 STARTUPINFOEXW
 STATUS_ABANDON_HIBERFILE
 STATUS_ABANDONED
 STATUS_ABANDONED_WAIT_0
 STATUS_ABANDONED_WAIT_63
-STGM
 STATUS_ACCESS_AUDIT_BY_POLICY
 STATUS_ACCESS_DENIED
 STATUS_ACCESS_DISABLED_BY_POLICY_DEFAULT
@@ -2108,6 +2117,7 @@ STATUS_WX86_UNSIMULATE
 STATUS_XML_ENCODING_MISMATCH
 STATUS_XML_PARSE_ERROR
 STATUS_XMLDSIG_ERROR
+STGM
 TASK_CREATION
 TaskDialog
 TaskScheduler
@@ -2143,9 +2153,9 @@ VER_SUITE_TERMINAL
 VER_SUITE_WH_SERVER
 VerLanguageName
 VerQueryValue
+VIRTUAL_KEY
 VirtualAlloc
 VirtualFree
-VIRTUAL_KEY
 VS_FIXEDFILEINFO
 WaitForSingleObject
 Windows.Win32.UI.Controls.IImageList
@@ -2353,11 +2363,11 @@ WM_WININICHANGE
 WritePrivateProfileSection
 WritePrivateProfileString
 WTS_CURRENT_SERVER_HANDLE
+WTS_PROCESS_INFO_EXW
+WTS_PROCESS_INFOW
 WTS_PROTOCOL_TYPE_CONSOLE
 WTS_PROTOCOL_TYPE_ICA
 WTS_PROTOCOL_TYPE_RDP
-WTS_PROCESS_INFO_EXW
-WTS_PROCESS_INFOW
 WTS_SESSION_INFO_1W
 WTSEnumerateSessionsEx
 WTSFreeMemory

src/PSADT/PSADT.Interop/PSADT.Interop.csproj

@@ -22,6 +22,7 @@
     <InternalsVisibleTo Include="PSADT.UserInterface" />
     <InternalsVisibleTo Include="PSADT.UserInterface.Interfaces" />
     <InternalsVisibleTo Include="PSADT.UserInterface.TestHarness" />
+    <InternalsVisibleTo Include="PSADT.WindowsRuntime" />
     <InternalsVisibleTo Include="PSAppDeployToolkit" />
   </ItemGroup>
 

src/PSADT/PSADT.WindowsRuntime/Management/Deployment/ManifestInformation.cs

@@ -0,0 +1,62 @@
+using System;
+using Windows.Win32.Storage.Packaging.Appx;
+
+namespace PSADT.WindowsRuntime.Management.Deployment
+{
+    /// <summary>
+    /// Represents information about a Windows Runtime package.
+    /// </summary>
+    public sealed record ManifestInformation
+    {
+        /// <summary>
+        /// Initializes a new instance of the <see cref="ManifestInformation"/> record based on the provided <see cref="IAppxManifestPackageId"/>.
+        /// </summary>
+        /// <param name="packageId">The package ID from which to initialize the package information.</param>
+        internal ManifestInformation(IAppxManifestPackageId packageId)
+        {
+            Name = packageId.GetName().ToString();
+            Architecture = (Interop.APPX_PACKAGE_ARCHITECTURE)packageId.GetArchitecture();
+            Publisher = packageId.GetPublisher().ToString();
+            ulong versionValue = packageId.GetVersion();
+            Version = new((int)(versionValue >> 48), (int)((versionValue >> 32) & 0xFFFF), (int)((versionValue >> 16) & 0xFFFF), (int)(versionValue & 0xFFFF));
+            ResourceId = packageId.GetResourceId().ToString();
+            PackageFullName = packageId.GetPackageFullName().ToString();
+            PackageFamilyName = packageId.GetPackageFamilyName().ToString();
+        }
+
+        /// <summary>
+        /// Gets the name of the package as defined in the manifest.
+        /// </summary>
+        public string Name { get; }
+
+        /// <summary>
+        /// Gets the processor architecture as defined in the manifest.
+        /// </summary>
+        public Interop.APPX_PACKAGE_ARCHITECTURE Architecture { get; }
+
+        /// <summary>
+        /// Gets the name of the package publisher as defined in the manifest.
+        /// </summary>
+        public string Publisher { get; }
+
+        /// <summary>
+        /// Gets the version of the package as defined in the manifest.
+        /// </summary>
+        public Version Version { get; }
+
+        /// <summary>
+        /// Gets the package resource identifier as defined in the manifest.
+        /// </summary>
+        public string ResourceId { get; }
+
+        /// <summary>
+        /// Gets the package full name.
+        /// </summary>
+        public string PackageFullName { get; }
+
+        /// <summary>
+        /// Gets the package family name.
+        /// </summary>
+        public string PackageFamilyName { get; }
+    }
+}