---
name: "CopyImage"
section: "3w"
platform: "linux"
package: "libwine-dev"
version: "1.4.1-4"
release: "Debian 7 (Wheezy)"
platforms: ["linux"]
url: "https://new.carta.tech/CopyImage"
---

# CopyImage(3w)

## NAME

**CopyImage** (USER32.@)

## SYNOPSIS

HANDLE CopyImage\
  (\
   HANDLE *hnd*,\
   UINT   *type*,\
   INT    *desiredx*,\
   INT    *desiredy*,\
   UINT   *flags*\
  )

## DESCRIPTION

CopyImage (**USER32**.@) Creates new image and copies attributes to it.

## PARAMS

*hnd* **\[In\]**  Handle to image to copy.

*type* **\[In\]**  Type of image to copy.

*desiredx* **\[In\]**  Desired width of new image.

*desiredy* **\[In\]**  Desired height of new image.

*flags* **\[In\]**  Copy *flags*.

## RETURNS

**Success:** Handle to newly created image

**Failure:** **NULL**.

## BUGS

Only Windows(tm) **NT** **4.0** supports the **LR\_COPYRETURNORG** flag for bitmaps, all other versions (95/2000/XP have been tested) ignore it.

## NOTES

If **LR\_CREATEDIBSECTION** is absent, the copy will be monochrome for a monochrome source bitmap or if **LR\_MONOCHROME** is present, otherwise the copy will have the same depth as the screen. The content of the image will only be copied if the bit depth of the original image is compatible with the bit depth of the screen, or if the source is a **DIB** section. The **LR\_MONOCHROME** flag is ignored if **LR\_CREATEDIBSECTION** is present.

## IMPLEMENTATION

Declared in **"winuser.h"**.

Implemented in **"dlls/user32/cursoricon.c"**.

Debug channel **"cursor"**.
