ResetDCA, fonction (wingdi.h)
La fonction ResetDC met à jour l’imprimante ou le contexte d’appareil de traçage spécifié (DC) à l’aide des informations spécifiées.
Syntaxe
HDC ResetDCA(
[in] HDC hdc,
[in] const DEVMODEA *lpdm
);
Paramètres
[in] hdc
Handle vers le contrôleur de domaine à mettre à jour.
[in] lpdm
Pointeur vers une structure DEVMODE contenant des informations sur le nouveau contrôleur de domaine.
Valeur de retour
Si la fonction réussit, la valeur de retour est un handle du contrôleur de domaine d’origine.
Si la fonction échoue, la valeur de retour est NULL .
Remarques
Une application utilise généralement la fonction ResetDC lorsqu’une fenêtre reçoit un message WM_DEVMODECHANGE. resetDC pouvez également être utilisé pour modifier l’orientation du papier ou les bacs à papier lors de l’impression d’un document.
La fonction ResetDC ne peut pas être utilisée pour modifier le nom du pilote, le nom de l’appareil ou le port de sortie. Lorsque l’utilisateur modifie la connexion de port ou le nom de l’appareil, l’application doit supprimer le contrôleur de domaine d’origine et créer un contrôleur de domaine avec les nouvelles informations.
Une application peut transmettre un contrôleur de domaine d’informations à la fonction ResetDC. Dans ce cas, ResetDC retourne toujours un contrôleur de domaine d’imprimante.
Note
L’en-tête wingdi.h définit ResetDC comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
| serveur minimum pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| plateforme cible | Windows |
| d’en-tête | wingdi.h (include Windows.h) |
| bibliothèque | Gdi32.lib |
| DLL | Gdi32.dll |
Voir aussi
fonctions de contexte d’appareil