Win10中的EnumWindows功能仅枚举桌面应用程序

时间:2016-07-05 13:57:26

标签: c# windows windows-10 pinvoke

EnumWindows上的documentation强调:

  

注意对于Windows 8及更高版本,EnumWindows仅枚举桌面应用程序的顶级窗口。

"桌面应用" "非桌面应用" 之间有什么区别?

这与 metro应用有关吗?

我问,因为 EnumWindows 在Win10中与Win7相比有所不同。

2 个答案:

答案 0 :(得分:5)

你是对的。 EnumWindows只会找到属于不是现代(Metro)应用程序的窗口。它将获得属于传统(桌面)程序的窗口。根据{{​​3}} FindWindowExseveral适用于所有类型的窗口,包括来自现代应用程序的窗口。

答案 1 :(得分:4)

另一种解决方案是使用win32u.dll中未公开的api,它具有原型:

   NTSTATUS WINAPI NtUserBuildHwndList
   (
     HDESK in_hDesk,
     HWND  in_hWndNext,
     BOOL  in_EnumChildren,
     BOOL  in_RemoveImmersive,
     DWORD in_ThreadID,
     UINT  in_Max,
     HWND *out_List,
     UINT *out_Cnt
   );

将其传递给具有最大条目数的HWND列表,将所有其他参数设置为零,输出Cnt给出返回的条目数。如果结果代码为STATUS_BUFFER_TOO_SMALL,则重新分配具有更多条目的列表,然后重试。

与Win10之前的版本相比,添加了参数RemoveImmersive。如果为TRUE,则返回与EnumWindows相同的列表(没有沉浸式窗口)。如果为FALSE,则返回完整列表。

列表的第一个条目是0x00000001作为句柄,必须将其忽略。

此api的优点在于,在调用FindWIndowEx时(在建立列表期间设置了锁定),不可能更改窗口列表。

EnumWindows,EnumDesktopWindows,EnumChildWindows,FindWindow,FindWindowEx都使用此api。

在此向Microsoft请求添加一个公共api EnumWindowsEx或EnumAllWindows,以便开发人员可以安全地枚举所有窗口。我了解他们将过滤器添加到EnumWindows来修复自定义任务列表,这些任务列表显示可见但隐蔽的沉浸式/地铁/ uwp窗口。但是应该为开发人员提供一种获取完整列表的方法。

更新:有关如何使用此api的示例,InitWin32uDLL执行win32u.dll的运行时加载,而lib_NtUserBuildHwndListW10是GetProcAddress指针

/********************************************************/
/* enumerate all top level windows including metro apps */
/********************************************************/

BOOL Gui_RealEnumWindows(WNDENUMPROC in_Proc, LPARAM in_Param)
{
    /* locals */
    INT   lv_Cnt;
    HWND  lv_hWnd;
    BOOL  lv_Result;
    HWND  lv_hFirstWnd;
    HWND  lv_hDeskWnd;
    HWND *lv_List;


  // only needed in Win8 or later
  if (gv_SysInfo.Basic.OsVersionNr < OSVER_WIN8)
    return EnumWindows(in_Proc, in_Param);

  // no error yet
  lv_Result = TRUE;

  // first try api to get full window list including immersive/metro apps
  lv_List = _Gui_BuildWindowList(0, 0, 0, 0, 0, &lv_Cnt);

  // success?
  if (lv_List)
  {
    // loop through list
    while (lv_Cnt-- > 0 && lv_Result)
    {
      // get handle
      lv_hWnd = lv_List[lv_Cnt];

      // filter out the invalid entry (0x00000001) then call the callback
      if (IsWindow(lv_hWnd))
        lv_Result = in_Proc(lv_hWnd, in_Param);
    }

    // free the list
    MemFree(lv_List);
  }
  else
  {
    // get desktop window, this is equivalent to specifying NULL as hwndParent
    lv_hDeskWnd = GetDesktopWindow();

    // fallback to using FindWindowEx, get first top-level window
    lv_hFirstWnd = FindWindowEx(lv_hDeskWnd, 0, 0, 0);

    // init the enumeration
    lv_Cnt  = 0;
    lv_hWnd = lv_hFirstWnd;

    // loop through windows found
    // - since 2012 the EnumWindows API in windows has a problem (on purpose by MS)
    //   that it does not return all windows (no metro apps, no start menu etc)
    // - luckally the FindWindowEx() still is clean and working
    while (lv_hWnd && lv_Result)
    {
      // call the callback
      lv_Result = in_Proc(lv_hWnd, in_Param);

      // get next window
      lv_hWnd = FindWindowEx(lv_hDeskWnd, lv_hWnd, 0, 0);

      // protect against changes in window hierachy during enumeration
      if (lv_hWnd == lv_hFirstWnd || lv_Cnt++ > 10000)
        break;
    }
  }

  // return the result
  return lv_Result;
}



HWND *_Gui_BuildWindowList
(
  HDESK in_hDesk,
  HWND  in_hWnd,
  BOOL  in_EnumChildren,
  BOOL  in_RemoveImmersive,
  UINT  in_ThreadID,
  INT  *out_Cnt
)
{
    /* locals */
    UINT  lv_Max;
    UINT  lv_Cnt;
    UINT  lv_NtStatus;
    HWND *lv_List;


  // is api not supported?
  if (!InitWin32uDLL())
    return NULL;

  // initial size of list
  lv_Max = 512;

  // retry to get list
  for (;;)
  {
    // allocate list
    if ((lv_List = (HWND*)MemAlloc(lv_Max*sizeof(HWND))) == NULL)
      break;

    // call the api
    lv_NtStatus = lib_NtUserBuildHwndListW10(
        in_hDesk, in_hWnd,
        in_EnumChildren, in_RemoveImmersive, in_ThreadID,
        lv_Max, lv_List, &lv_Cnt);

    // success?
    if (lv_NtStatus == NOERROR)
      break;

    // free allocated list
    MemFree(lv_List);

    // clear
    lv_List = NULL;

    // other error then buffersize? or no increase in size?
    if (lv_NtStatus != STATUS_BUFFER_TOO_SMALL || lv_Cnt <= lv_Max)
      break;

    // update max plus some extra to take changes in number of windows into account
    lv_Max = lv_Cnt + 16;
  }

  // return the count
  *out_Cnt = lv_Cnt;

  // return the list, or NULL when failed
  return lv_List;
}