函数功能；该函数把当前设备上下文环境（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。