### 函数功能

该函数为位图指定首选的大小。这些大小可以为应用程序所用，然而不能被系统所用。

### 函数原型

BOOL SetBitmapDimensionEx(HBITMAP bBitmap, int nWidth, int nHeight, LPSIZE lpSize)；

### 参数

hBitmap：指向位图的句柄。该位图不可能是DIB类型的位图。
nWidth：指定位图的宽度，以0.1毫米为单位。
nHeight：指定位图的高度，以0.1毫米为单位。
lpSize：指向SIZE结构的指针。该结构用来接收该位图以前的大小。该指针可以为NULL。

### 返回值

如果该函数成功，那么返回值非零；如果该函数失败，那么返回值为零。
Windows NT：若想获得更多错误信息，请调用GetLastError函数。
备注：应用程序可以通过调用GetBitmapDimensionEX函数来检索位图的大小，该位图的大小是用函数SetBitmapDimensionEX设置的。
由hBitmap参数标识的位图不能是DIB类型，DIB类型位图是由函数GreateDIBSection来创建的。如果该位图为DIB类型，那么函数SetBitmapDimensionEX会失败。

### 速查

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