### 函数功能

该函数激活一个窗口。该窗口必须与调用线程的消息队列相关联。

### 函数原型

HWND SetActiveWindow（HWND hWnd）；

### 参数

hWnd：将被激活的最顶层窗口。

### 返回值

若函数调用成功，则返回原先活动窗口的句柄。若函数调用失败，则返回值为NULL。若要获得更多错误信息，可以调用GetLastError函数。
备注：SetActiveWindow函数激活一个窗口，但当应用程序处于后台时，将不激活指定窗口。当应用程序激活窗口时处于前台，则窗口将被放到前台。
若hWnd参数指定的窗口是被调用线程创建的，调用线程的活动窗口的状态将被设置到hWnd中。否则，调用线程的活动窗口的状态被设为NULL。
从另一方面讲，SetForegroundWindow窗口函数激活一个窗口并将其强制为前台的。当应用程序要显示关键错误或需要用户立即注意的信息时，应只能调用SetForegroundWindow函数。
使用AttachThreadInput函数可将一个线程的输人处理连接到其他线程。这使得调用SetActiveWindow函数的线程可以激活与其他线程的消息队列相关的窗口。

### 速查

Windows NT：3.1及以上版本；Windows：95及以上版本；Windows CE：1.0及以上版本；头文件：winuser.h；库文件：user32.lib。