函数功能；该函数把当前设备上下文环境（DC）的笔颜色设置为指定颜色值。如果设备不能提供指定的颜色值，颜色就设为最近的物理颜色。

函数原型：COLORREF SetDCPenColor(HDC hdc, COLORREF crColor)；

参数：

hdc：设备上下文环境的句柄。

crColor：指定新笔颜色。

返回值：如果成功，则返回值指定先前DC笔颜色为某个COLORREF值；如果失败，返回CLR_INVALID。

注释：即使系统备用笔DC_PEN没有被选入DC，该函数仍将返回先前DC_PEN的颜色，但是在绘制操作中这将不被使用，直到系统备用DC_PEN被选入DC为止。

设置颜色可以参见设置笔或画笔颜色的例子，使用DC_BRUSH或DC_PEN参数的GetStockObject函数可与SetDCPenColor和SetDCBrushColor函数交换使用。

ICM：如果ICM可用就执行颜色管理。详情参见ForegroundldleProc钩子处理过程。

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