### 函数功能

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

### 函数原型

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。