Fonction RestoreDC (wingdi.h)
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