GetDIBColorTable

函式功能：該函式從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。