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

Статья
08/27/2023

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

Синтаксис

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

Параметры

[in] hdc

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

[in] nSavedDC

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

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

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

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

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

Требования


Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	wingdi.h (включая Windows.h)
Библиотека	Gdi32.lib
DLL	Gdi32.dll

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

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

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

SaveDC

Share via