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

    函数原型：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。