Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This function restores a device context (DC) to the specified state. The device context is restored by popping state information off a stack created by earlier calls to the SaveDCfunction.

Syntax 

BOOL RestoreDC(
  HDC 
hdc, 
  int 
nSavedDC
);

Parameters

hdc

[in] Handle to the device context.

nSavedDC

[in] Specifies the instance of the device context to be restored.

If this parameter is positive, nSavedDCrepresents a specific instance of the device context to be restored.

If this parameter is negative, nSavedDCrepresents an instance relative to the current device context.

For example, –1 restores the most recently saved state.

Return Value

Nonzero indicates success.

Zero indicates failure.

To get extended error information, call GetLastError.

Remarks

The stack can contain the state information for several instances of the device context.

If the state specified by the given parameter is not at the top of the stack, RestoreDCdeletes all state information between the top of the stack and the specified instance.

Requirements

Header windows.h
Library coredll.lib
Windows Embedded CE Windows CE 1.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also