### 函数功能

该函数通过把客户区域的当前颜色重新映射到发前被映射过的逻辑调色板，来更新指定设备环境的客户区域。

### 函数原型

BOOL UpdateColors(HDC hdc)；

### 参数

hdc：设备环境句柄。

### 返回值

如果成功返回值非零，如果失败，返回值为零。
Windows NT：若想获得更多错误信息，请调用GetLastError函数。
注释：通过调用GetDeviceCaps函数和设置RASTERCAPS常量，一个应用可以确定一个设备是否支持调色板操作，当系统调色板发生变化时，一个映射逻辑调色板非活动窗口可以通过调用Updatecolors，作为一种选择方法刷新它的客户区域。
UpdateColors函数更新一个客户区域比刷新该区域要快，但是，由于在系统调色板改变之前UpdateColors函数要进行基于每个像素颜色的色彩转换，因此，每一次调用该函数会导致一些颜色失真。
一旦收到WM_PALETTECHANGED消息，该函数必须马上被调用。

### 速查

Windows NT：3.1及以上版本；Windows：95及以上版本；Windows CE：不支持；头文件：wingdi.h；库文件：gdi32.lib。