### 函数功能

该函数返回一个颜色值，该值和系统调色板的一个颜色相一致，当使用一个特定的颜色值时，该颜色被显示。

### 函数原型

COLORREF GetNearColor (HDC hdc, COLORREF crColor)；

### 参数

hdc：设备环境句柄。
crColor：定义一个与请求颜色相一致的颜色值。

### 返回值

如果函数执行成功，返回值与系统调色板中的一种颜色相一致；如果失败，返回值是CLR_INVALID。
Windows NT：若想获得更多错误信息，请调用GelLastError函数。
Windows CE：GetNearestcolor函数从选定的设备环境中返回的一种颜色和一个指定的颜色非常匹配。

### 速查

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