### 函数功能

该函数创建一个逻辑彩色调色板。

### 函数原型

HPALETTE CreatePalette(CONST LOGPALETTE *lplgpl)；

### 参数

lplgpl：指向LOGPALETTE结构的指针，该结构包含了逻辑调色板中的色彩信息。

### 返回值

如果函数成功，则返回值是一个逻辑调色板的句柄；如果失败，返回值为NULL（空）。
Windows NT：若想获得更多错误信息，请调用GetLastError函数。
注释：通过调用GetDevice Caps函数和定义RASTERCAPS常量一个应用可以确定一个设备是否支持调色板操作。一旦应用创建了一个逻辑调色板，它可以通过调用Select Palette函数把该调色板选入设备环境中。通过调用RealizePalette函数选入设备环境中的调色板可被映射。
当不再需要该调色板时，可调用DeleteObject函数删除它，由于Windows CE并不仲裁前景和背景应用的调色板，调色板并不随着Windows系统颜色而自动退色，因此由该函数创建的调色板的颜色入口点数目和LOGPALETTE结构中的PalNumEntries相同。

### 速查

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