函数功能：该函数检取指定逻辑调色板入口的索引，以与一个特定的颜色值相匹配。

函数原型：UINT GetNearestPaletteIndex(HPALETTE hpal, COLORREF crColor)；

参数：

hpal：标识一个逻辑颜色调色板。

crColor：指定一个匹配的颜色。

返回值：如果函数执行成功，返回值是一个逻辑调色板入口的索引；如果函数执行失败，返回值是CLR_INVALID。

Windows NT：若想获得更多错误信息，请调用GetLastError函数。

注释：通过调用GetDevicecaps函数和指定PASTERCAPS常量，一个应用可以确定一个设备是否支持调色板操作。如果给定的逻辑调色板包含设置PC_EXPLICT标志的入口点，那么返回值是不确定的。

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