Windows 10/11新版本中SetWindowPos返回false的原因与修复方案

在.NET MAUI中开发顶部固定AppBar，需求是将其固定在屏幕顶部并缩小系统工作区，确保AppBar不被其他窗口覆盖。目前通过user32.dll的SetWindowPos调整工作区时，仅Windows 11 21H2返回true，Windows 10 21H2/22H2、Windows 11 22H2（带补丁）均返回false，预期效果（最大化窗口不覆盖AppBar）仅在Windows 11 21H2正常生效。

现有代码：

IntPtr desktopWindow = GetDesktopWindow();
var setPos = SetWindowPos(desktopWindow, IntPtr.Zero, 0, _APPBARHEIGHT, 0, 0, (uint)(SetWindowPosFlags.SWP_NOSIZE | SetWindowPosFlags.SWP_NOZORDER));//Windows 11 v21H2返回true
RECT rect = new RECT();
rect.Left = 0;
rect.Top = _APPBARHEIGHT;
rect.Right = _ScreenWidth;
rect.Bottom = _ScreenHeight - _APPBARHEIGHT;
var sysparam = SystemParametersInfo(0x002F, 0, ref rect, 0x0002);//返回true

1. 系统API权限限制变更：Windows 11 22H2及后续补丁、Windows 10后期版本中，微软限制了对桌面窗口（GetDesktopWindow返回句柄）的直接SetWindowPos调用，这类操作会被系统安全机制拦截，导致函数返回false。
2. 非标准实现方式：直接移动桌面窗口并非Windows官方认可的工作区调整方案，旧版本Windows中生效属于偶然情况，不具备跨版本兼容性。

正确的实现方式是使用Windows官方的SHAppBarMessage API注册应用栏，这是系统原生支持的方案，可在所有目标Windows版本中稳定工作。

1. 定义必要的API和结构体 #

using System.Runtime.InteropServices;

public enum ABMsg
{
    ABM_NEW = 0,
    ABM_REMOVE = 1,
    ABM_QUERYPOS = 2,
    ABM_SETPOS = 3
}

public enum ABEdge
{
    ABE_TOP = 1
}

[StructLayout(LayoutKind.Sequential)]
public struct APPBARDATA
{
    public int cbSize;
    public IntPtr hWnd;
    public int uCallbackMessage;
    public int uEdge;
    public RECT rc;
    public IntPtr lParam;
}

[StructLayout(LayoutKind.Sequential)]
public struct RECT
{
    public int Left;
    public int Top;
    public int Right;
    public int Bottom;
}

[DllImport("shell32.dll")]
public static extern IntPtr SHAppBarMessage(ABMsg dwMessage, ref APPBARDATA pData);

2. 注册顶部AppBar #

在MAUI窗口初始化完成后执行以下代码（需获取当前窗口的原生句柄）：

// 获取MAUI窗口的Windows原生句柄
var mauiWindow = Application.Current.Windows[0];
var winUIWindow = (MauiWinUIWindow)mauiWindow.Handler.PlatformWindow;
IntPtr appWindowHandle = winUIWindow.WindowHandle;

// 初始化AppBar数据
APPBARDATA appBarData = new APPBARDATA();
appBarData.cbSize = Marshal.SizeOf(typeof(APPBARDATA));
appBarData.hWnd = appWindowHandle;
appBarData.uEdge = (int)ABEdge.ABE_TOP;

// 设置AppBar尺寸（顶部全屏宽度，高度为_APPBARHEIGHT）
var screen = System.Windows.Forms.Screen.PrimaryScreen;
appBarData.rc.Left = screen.Bounds.Left;
appBarData.rc.Top = screen.Bounds.Top;
appBarData.rc.Right = screen.Bounds.Right;
appBarData.rc.Bottom = _APPBARHEIGHT;

// 注册AppBar
SHAppBarMessage(ABMsg.ABM_NEW, ref appBarData);

// 请求系统确认位置并调整工作区
SHAppBarMessage(ABMsg.ABM_QUERYPOS, ref appBarData);
// 强制锁定AppBar在顶部，避免系统调整
appBarData.rc.Top = screen.Bounds.Top;
appBarData.rc.Bottom = _APPBARHEIGHT;
SHAppBarMessage(ABMsg.ABM_SETPOS, ref appBarData);

// 设置窗口置顶和无边框（适配MAUI）
winUIWindow.ExtendsContentIntoTitleBar = false;
winUIWindow.WindowHandle.SetWindowPos(IntPtr.Zero, 0, 0, screen.Bounds.Width, _APPBARHEIGHT, 
    (int)(SetWindowPosFlags.SWP_NOZORDER | SetWindowPosFlags.SWP_SHOWWINDOW));

3. 窗口关闭时注销AppBar #

在窗口关闭事件中执行注销操作，避免残留工作区修改：

APPBARDATA appBarData = new APPBARDATA();
appBarData.cbSize = Marshal.SizeOf(typeof(APPBARDATA));
appBarData.hWnd = appWindowHandle;
SHAppBarMessage(ABMsg.ABM_REMOVE, ref appBarData);

关键注意事项 #

• SHAppBarMessage会自动通知系统调整工作区，最大化窗口会自动避开AppBar区域，无需手动调用SystemParametersInfo或修改桌面窗口。
• 确保MAUI窗口设置为无边框且置顶，避免被其他窗口遮挡。

内容的提问来源于stack exchange，提问作者Kuvach