Throw HttpSysException with HttpInitialize status details

src/Servers/HttpSys/src/HttpSysListener.cs

@@ -2,6 +2,7 @@
 // The .NET Foundation licenses this file to you under the MIT license.
 
 using System.Buffers;
+using System.ComponentModel;
 using System.Diagnostics;
 using Microsoft.AspNetCore.Connections;
 using Microsoft.AspNetCore.Http;
@@ -52,7 +53,7 @@ public HttpSysListener(HttpSysOptions options, IMemoryPoolFactory<byte> memoryPo
 
         if (!HttpApi.Supported)
         {
-            throw new PlatformNotSupportedException();
+            throw CreateHttpInitializeFailureException(HttpApi.HttpInitializeStatusCode);
         }
 
         MemoryPool = memoryPoolFactory.Create(new MemoryPoolOptions { Owner = "httpsys" });
@@ -256,6 +257,19 @@ private void DisposeInternal()
         _serverSession.Dispose();
     }
 
+    internal static PlatformNotSupportedException CreateHttpInitializeFailureException(uint httpInitializeStatusCode)
+    {
+        if (httpInitializeStatusCode == ErrorCodes.ERROR_SUCCESS)
+        {
+            return new PlatformNotSupportedException();
+        }
+
+        var httpInitializeException = new Win32Exception((int)httpInitializeStatusCode);
+        return new PlatformNotSupportedException(
+            $"HttpInitialize failed with status code 0x{httpInitializeStatusCode:X8} (HRESULT 0x{httpInitializeException.HResult:X8}).",
+            httpInitializeException);
+    }
+
     /// <summary>
     /// Accept a request from the incoming request queue.
     /// </summary>

src/Servers/HttpSys/src/NativeInterop/HttpApi.cs

@@ -72,10 +72,12 @@ internal static unsafe uint HttpSetRequestProperty(SafeHandle requestQueueHandle
     internal static bool SupportsClientHello { get; }
     internal static bool SupportsQueryTlsCipherInfo { get; }
     internal static bool Supported { get; }
+    internal static uint HttpInitializeStatusCode { get; }
 
     static unsafe HttpApi()
     {
         var statusCode = PInvoke.HttpInitialize(Version, HTTP_INITIALIZE.HTTP_INITIALIZE_SERVER | HTTP_INITIALIZE.HTTP_INITIALIZE_CONFIG);
+        HttpInitializeStatusCode = statusCode;
 
         if (statusCode == ErrorCodes.ERROR_SUCCESS)
         {

src/Servers/HttpSys/test/Tests/HttpSysListenerTests.cs

@@ -0,0 +1,32 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+
+using System.ComponentModel;
+using Xunit;
+
+namespace Microsoft.AspNetCore.Server.HttpSys;
+
+public class HttpSysListenerTests
+{
+    [Fact]
+    public void CreateHttpInitializeFailureException_WithErrorCode_IncludesWin32ExceptionDetails()
+    {
+        var errorCode = ErrorCodes.ERROR_ACCESS_DENIED;
+        var exception = HttpSysListener.CreateHttpInitializeFailureException(errorCode);
+        var expectedWin32Exception = new Win32Exception((int)errorCode);
+
+        Assert.Contains($"status code 0x{errorCode:X8}", exception.Message);
+        Assert.Contains($"HRESULT 0x{expectedWin32Exception.HResult:X8}", exception.Message);
+
+        var win32Exception = Assert.IsType<Win32Exception>(exception.InnerException);
+        Assert.Equal((int)errorCode, win32Exception.NativeErrorCode);
+    }
+
+    [Fact]
+    public void CreateHttpInitializeFailureException_WithSuccessCode_ReturnsExceptionWithoutInnerException()
+    {
+        var exception = HttpSysListener.CreateHttpInitializeFailureException(ErrorCodes.ERROR_SUCCESS);
+
+        Assert.Null(exception.InnerException);
+    }
+}