Windows 桌面壁紙程序化控制：IActiveDesktop 接口實戰

需求場景

應用程序需要動態設置桌面壁紙（如每日必應圖片、用戶上傳圖片輪播），且需支持 JPG/PNG/BMP 多格式、居中/平鋪/拉伸多模式。

核心方案：IActiveDesktop COM 接口

自 Windows 2000 起，Shell 提供 IActiveDesktop 接口（CLSID: CLSID_ActiveDesktop），比傳統 SystemParametersInfo(SPI_SETDESKWALLPAPER) 更強大：

• 支持 URL 直接設置網絡圖片
• 獨立控制壁紙樣式（居中/平鋪/拉伸）
• 支持多顯示器獨立設置
• 可啟用/禁用 Active Desktop 組件

關鍵代碼實現（C++/ATL）

#define NO_WIN32_LEAN_AND_MEAN  // 必須在包含windows.h之前定義
#include               // IActiveDesktop 定義
#include              // CComPtr 智能指針

HRESULT SetWallpaper(const wchar_t* imagePath, DWORD style = 0) {
    // 1. 初始化 COM 庫
    HRESULT hr = CoInitializeEx(NULL, COINIT_APARTMENTTHREADED);
    if (FAILED(hr)) return hr;

    // 2. 創建 ActiveDesktop 實例
    CComPtr pActiveDesktop;
    hr = pActiveDesktop.CoCreateInstance(CLSID_ActiveDesktop);
    if (FAILED(hr)) {
        CoUninitialize();
        return hr;
    }

    // 3. 設置壁紙路徑（支持本地文件、UNC路徑、HTTP/HTTPS URL）
    hr = pActiveDesktop->SetWallpaper(imagePath, 0);
    if (FAILED(hr)) {
        CoUninitialize();
        return hr;
    }

    // 4. 設置顯示樣式
    // WPSTYLE_CENTER (0), WPSTYLE_TILE (1), WPSTYLE_STRETCH (2), WPSTYLE_FIT (3), WPSTYLE_FILL (4), WPSTYLE_SPAN (5)
    COMPONENTSOPT compOpt = { sizeof(COMPONENTSOPT) };
    hr = pActiveDesktop->GetDesktopItemOptions(&compOpt, 0);
    if (SUCCEEDED(hr)) {
        compOpt.dwSize = sizeof(COMPONENTSOPT);
        compOpt.dwFlags = COMP_ELEM_TYPE | COMP_ELEM_CHECKED | COMP_ELEM_POSITION;
        // 這裡簡化處理，實際需根據style設置WPSTYLE_*常量
        hr = pActiveDesktop->SetDesktopItemOptions(&compOpt, 0);
    }

    // 5. 應用變更（AD_APPLY_ALL: 所有用戶/所有顯示器）
    if (SUCCEEDED(hr)) {
        hr = pActiveDesktop->ApplyChanges(AD_APPLY_ALL);
    }

    CoUninitialize();
    return hr;
}

關鍵點詳解

C# 互操作封裝

using System;
using System.Runtime.InteropServices;

public static class WallpaperManager {
    [ComImport, Guid("F490EB00-1240-11D1-9888-006097DEACF9")]
    [InterfaceType(ComInterfaceType.InterfaceIsIUnknown)]
    interface IActiveDesktop {
        [PreserveSig] int ApplyChanges(uint dwFlags);
        [PreserveSig] int GetWallpaper([Out, MarshalAs(UnmanagedType.LPWStr)] StringBuilder pwszWallpaper, int cchWallpaper, uint dwReserved);
        [PreserveSig] int SetWallpaper([In, MarshalAs(UnmanagedType.LPWStr)] string pwszWallpaper, uint dwReserved);
        [PreserveSig] int GetWallpaperOptions(ref WALLPAPEROPT pwpo, uint dwReserved);
        [PreserveSig] int SetWallpaperOptions(ref WALLPAPEROPT pwpo, uint dwReserved);
        // ... 其他成員
    }

    [StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
    struct WALLPAPEROPT {
        public int dwSize;
        public int dwStyle;  // WPSTYLE_*
    }

    const uint AD_APPLY_ALL = 0x00000001;
    const int CLSCTX_INPROC_SERVER = 0x1;
    const int S_OK = 0;

    [DllImport("shell32.dll")]
    static extern int CoCreateInstance(ref Guid rclsid, IntPtr pUnkOuter, uint dwClsContext, ref Guid riid, out IActiveDesktop ppv);

    public static void SetWallpaper(string path, int style = 0) {
        Guid clsid = new Guid("75048700-EF1F-11D0-9888-006097DEACF9"); // CLSID_ActiveDesktop
        Guid iid = typeof(IActiveDesktop).GUID;
        
        if (CoCreateInstance(ref clsid, IntPtr.Zero, CLSCTX_INPROC_SERVER, ref iid, out var desktop) == S_OK) {
            desktop.SetWallpaper(path, 0);
            var opt = new WALLPAPEROPT { dwSize = Marshal.SizeOf(), dwStyle = style };
            desktop.SetWallpaperOptions(ref opt, 0);
            desktop.ApplyChanges(AD_APPLY_ALL);
            Marshal.ReleaseComObject(desktop);
        }
    }
}

常見問題排查

1. 壁紙不生效：組策略禁用 Active Desktop、圖片格式不支持（需 BMP/JPG/PNG）、路徑過長（>260字符）
2. 權限拒絕：需在用戶會話上下文運行，服務模式下需使用 WTSQueryUserToken + CreateProcessAsUser 注入用戶會話
3. 多顯示器不同圖片：Win10+ 使用 IDesktopWallpaper 接口（SetWallpaper(monitorID, path)）
4. 透明 PNG 變黑：Active Desktop 不支持透明通道，需預合成背景色或轉 BMP

現代替代方案

Windows 8+ 推薦使用 IDesktopWallpaper 接口（shobjidl.h），提供：

• 每顯示器獨立壁紙
• 幻燈片播放內建支持
• 更好的高 DPI 適配

但 IActiveDesktop 仍是 XP/Win7 兼容的最佳選擇，兩者可根據運行時版本動態選擇。