Fonction RestoreDC (wingdi.h)

  • Article

La fonction RestoreDC restaure un contexte d’appareil (DC) à l’état spécifié. Le contrôleur de domaine est restauré en supprimant les informations d’état d’une pile créée par des appels antérieurs à la fonction SaveDC .

Syntaxe

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

Paramètres

[in] hdc

Handle du contrôleur de domaine.

[in] nSavedDC

État enregistré à restaurer. Si ce paramètre est positif, nSavedDC représente un instance spécifique de l’état à restaurer. Si ce paramètre est négatif, nSavedDC représente un instance par rapport à l’état actuel. Par exemple, -1 restaure l’état enregistré le plus récent.

Valeur retournée

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro.

Remarques

Chaque contrôleur de domaine conserve une pile d’états enregistrés. La fonction SaveDC envoie l’état actuel du contrôleur de domaine à sa pile d’états enregistrés. Cet état ne peut être restauré que sur le même contrôleur de domaine à partir duquel il a été créé. Une fois l’état restauré, l’état enregistré est détruit et ne peut pas être réutilisé. En outre, tous les états enregistrés après la création de l’état restauré sont également détruits et ne peuvent pas être utilisés. En d’autres termes, la fonction RestoreDC affiche l’état restauré (et tous les états suivants) à partir de la pile d’informations d’état.

Configuration requise

   
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête wingdi.h (inclure Windows.h)
Bibliothèque Gdi32.lib
DLL Gdi32.dll

Voir aussi

Fonctions de contexte d’appareil

Vue d’ensemble des contextes d’appareil

SaveDC