### 函数功能

该函数从DIB位图的颜色表中检索RGB（红、绿、蓝）颜色值，此DIB位图是当前选入指定设备环境中的位图。

### 函数原型

UINT GetDIBColorTable(HDC hdc,UINt uStartindex, UINT cEntries, RGBQUAD *pColors)

### 参数

hdc：指定设备环境，DIB类位图必须选入到该设备环境中。
uStartindex：一个从零开始的颜色表索引值，该索引值指定了要检索的第1个颜色色表项。
cEntries：指定要检索的颜色表项的数目。
pColors：指向一个缓冲区的指针，该缓冲区接收一个RGBQUAD结构数值，该结构包含DIB颜色表中的颜色信息。该缓冲区必须足够大，以包含象cEntries参数值一样多的RGBQUAD数据结构。

### 返回值

如果函数执行成功，那么返回值就是函数检索到的颜色表项的数目；如果函数执行失败，那么返回值为0。
Windows NT：若想获得更多错误信息，请调用GetLastError函数。
备注：GetDIBColorTable函数应该是用来检索使用1、4或8位像素点格式的DIB位图的颜色表的，与位图相关的BITMAPINFOHEADER结构中的成员biBitCount规定了每个像素点的位数。biBitCount值大于8的DIB类位图没有颜色表，但它们有相关的颜色掩码。可以调用GetObject函数来检索那些颜色掩码。

### 速查

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