Функция RestoreDC (wingdi.h)

Функция RestoreDC восстанавливает контекст устройства (DC) до указанного состояния. Контроллер домена восстанавливается путем получения сведений о состоянии из стека, созданного ранее вызовами функции SaveDC .

Синтаксис

BOOL RestoreDC(
  [in] HDC hdc,
  [in] int nSavedDC
);

Параметры

[in] hdc

Дескриптор контроллера домена.

[in] nSavedDC

Сохраненное состояние для восстановления. Если этот параметр является положительным, nSavedDC представляет конкретный экземпляр состояния для восстановления. Если этот параметр является отрицательным, nSavedDC представляет экземпляр относительно текущего состояния. Например, значение -1 восстанавливает последнее сохраненное состояние.

Возвращаемое значение

Если функция выполняется успешно, возвращается ненулевое значение.

Если функция выполняется неудачно, возвращается нулевое значение.

Комментарии

Каждый контроллер домена поддерживает стек сохраненных состояний. Функция SaveDC передает текущее состояние контроллера домена в стек сохраненных состояний. Это состояние можно восстановить только в том же контроллере домена, из которого оно было создано. После восстановления состояния сохраненное состояние уничтожается и не может быть использовано повторно. Кроме того, все состояния, сохраненные после создания восстановленного состояния, также уничтожаются и не могут использоваться. Другими словами, функция RestoreDC извлекает восстановленное состояние (и все последующие состояния) из стека сведений о состоянии.

Требования

См. также раздел

Функции контекста устройства

Общие сведения о контекстах устройств

SaveDC