GetSystemPaletteEntries

函數功能：該函數從與指定設備環境有關係的系統調色板中檢取調色板入口點的範圍。

函數原型：UINT GetSystemPaletteEntries(HDC hdc, UINT iStartIndex, UINT nEntries, LPPALETTEENTRY lppe)；

參數：

hdc：設備環境句柄。

iStartIndex：指定從系統調色板中檢取的第一個入口點。

nEntries：指定從系統調色板中檢取入口點的數目。

lppe：指向PALETTEENTRY結構數組的指針，它檢取調色板入口點，該數組至少要包含由nEntries參數所指定的結構數，如果該參數為NULL（空），則該函數返回調色板中入口點的總數。

返回值：如果函數執行成功，返回值是從調色板中檢取的入口點數；如果失敗，返回值為零。

Windows NT：若想獲得更多錯誤信息，請調用GetLastError函數。

註釋：通過調用GetDeviceCaps函數和定義RASTERCAPS常用量，一個應用可以確定一個設備是否支持調色板操作。

Windows CE：如果和hdc相關的設備沒有一個可設置的調色板，那麼GetSystemPaletteEntries函數就會失敗，在使用GetsystempaletteEntries之前，可使用GetDeviceCaps函數來確定考查該設備是否有一個可設置的調色板。

速查：Windows NT：3.1及以上版本；Windows：95及以上版本；Windows CE：2.0及以上版本；頭文件：wingdi.h；庫文件：gdi32.lib。