Partager via


Fonction ResetPrinter

La fonction ResetPrinter spécifie le type de données et les valeurs de mode appareil à utiliser pour l’impression des documents envoyés par la fonction StartDocPrinter . Ces valeurs peuvent être remplacées à l’aide de la fonction SetJob après le démarrage de l’impression de documents.

Syntaxe

BOOL ResetPrinter(
  _In_ HANDLE             hPrinter,
  _In_ LPPRINTER_DEFAULTS pDefault
);

Paramètres

hPrinter [in]

Handle à l’imprimante. Utilisez la fonction OpenPrinter ou AddPrinter pour récupérer un handle d’imprimante.

pDefault [in]

Pointeur vers une structure PRINTER_DEFAULTS .

La fonction ResetPrinter ignore le membre DesiredAccess de la structure PRINTER_DEFAULTS . Définissez ce membre sur zéro.

Valeur retournée

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

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

Notes

Notes

Il s’agit d’une fonction bloquante ou synchrone qui peut ne pas être retournée immédiatement. La rapidité avec laquelle cette fonction retourne dépend de facteurs d’exécution tels que l’status réseau, la configuration du serveur d’impression et les facteurs d’implémentation du pilote d’imprimante qui sont difficiles à prédire lors de l’écriture d’une application. L’appel de cette fonction à partir d’un thread qui gère l’interaction avec l’interface utilisateur peut donner l’impression que l’application ne répond pas.

Spécifications

Condition requise Valeur
Client minimal pris en charge
Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge
Windows 2000 Server [applications de bureau uniquement]
En-tête
Winspool.h (inclure Windows.h)
Bibliothèque
Winspool.lib
DLL
Winspool.drv
Noms Unicode et ANSI
ResetPrinterW (Unicode) et ResetPrinterA (ANSI)

Voir aussi

Impression

Fonctions API du spouleur d’impression

OpenPrinter

PRINTER_DEFAULTS

StartDocPrinter

SetJob