### 函数功能

该函数用来对目前进入指定设备环境的设备无关位图（DIB）颜色表中的项设置RGB（红、绿、蓝）颜色值。

### 函数原型

UINT SetDIBColorTable(HDC hdc, UINT uStartindex, UINT cEntries, CONST RGBQUAD *pColors)；

### 参数

hdc：指定设备环境。一个与设备无关位图必须被选入到该设备环境中。
uStartindex：一个从零开始的颜色表索引，该索引指定了要设置的第1个颜色表项。
cEntries：指定要设置的颜色表项的数目。
pColors：指向RGBQUAD结构数组的指针。该结构包含了用于DIB颜色表的新颜色信息。

### 返回值

如果函数执行成功，那么返回值就是该函数设置的颜色表项的数目；如果函数执行失败，那么返回值为0。Windows NT：若想获得更多错误信息，请调用GetLastError函数。
备注：使用该函数是用来对那些使用1、4、或8位／像素格式的DIB位图的颜色表进行设置的。位图信息头结构中的成员BitCount表示了位图中每像素占多少位这种信息。
注意：位图信息头结构可以为：
Windows NT 3.51和以前版；BITMAPINFOHEADER，BITMAPINFOHEADER结构指定了每像素占多少位。BiBitCount值大于8的设备无关位图（DIB）没有颜色表。
Windows NT 4.0和Windows 95：BITMAPV4HEADER，对于Windows NT 4.0和Windows 95，与位图相关的BITMAPV4HEADER结构成员bV 4BitCount指定了每像素点占的位数。bV 4BitCount值大于8的DIB没有颜色表。
Windows NT 5.0和Windows 98：BITMAPV5HEADER，对于Windows NT 5.0和Windows 98，与位图相关的BITMAPV4HEADER结构中的成员bV 5BitCount指定了位图中每像素点占的位数。bV 5BitCount值大于8的DIB位图没有颜色表。
ICM：不进行颜色管理。

### 速查

Windows NT：3.5及以上版本；Windows：95及以上版本；Windows CE：不支持；头文件：wingdi.h：库文件：gdi32.lib。