DevCloseDC

This function closes a device context.

Syntax

DevCloseDC (hdc)

Parameters

hdc (HDC) - input

Device-context handle.

Returns

hmf (HMF) - returns

Error indicator metafile handle (for a metafile device context)

DEV_ERROR - Error occurred

DEV_OK - Device closed, but not a metafile device context.

Other Device closed, a metafile device context whose metafile handle is returned.

Errors

Possible returns from WinGetLastError:

PMERR_NOT_CREATED_BY_DEVOPENDC (0x20DC)

An attempt has been made to destroy a device context using DevCloseDC that was not created using DevOpenDC.

PMERR_DC_IS_ASSOCIATED (0x2017)

An attempt was made to associate a presentation space with a device context that was already associated or to destroy a device context that was associated.

PMERR_INV_HDC (0x207C)

An invalid device-context handle or (micro presentation space) presentation-space handle was specified.

Remarks

If the device context is currently associated with a presentation space, or if it is created with the WinOpenWindowDC call (that is, it is a screen device context), an error is raised, and the device context is not closed.

If the device context being closed is a memory device context that has a bit map currently selected into it (see GpiSetBitmap in the Presentation Manager Programming Reference) the bit map is automatically deselected before the device context is closed.

Any clip region currently in use for this device context is deleted.

Example Code

This example calls DevCloseDC to close a device context based on the handle returned from DevOpenDC.

 #define INCL_DEV  /* Device Function definitions */
 #include <os2.h>
 
 HDC hdc;   /* Device-context handle */
 HMF hmf;   /* error code (or metafile handle if metafile device context) */
 
 /* close the device context associated with handle hdc */
 hmf = DevCloseDC(hdc);

Prerequisite Functions

• DevOpenDC