Funzione ResetPrinter

La funzione ResetPrinter specifica i valori del tipo di dati e della modalità dispositivo da usare per la stampa di documenti inviati dalla funzione StartDocPrinter . Questi valori possono essere sottoposti a override usando la funzione SetJob dopo l'avvio della stampa dei documenti.

Sintassi

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

Parametri

hPrinter [in]

Gestire la stampante. Usare la funzione OpenPrinter o AddPrinter per recuperare un handle della stampante.

pDefault [in]

Puntatore a una struttura PRINTER_DEFAULTS .

La funzione ResetPrinter ignora il membro DesiredAccess della struttura PRINTER_DEFAULTS . Impostare tale membro su zero.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è un valore diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero.

Commenti

Nota

Si tratta di una funzione di blocco o sincrona e potrebbe non restituire immediatamente. La velocità con cui questa funzione restituisce dipende da fattori di runtime come lo stato della rete, la configurazione del server di stampa e i fattori di implementazione del driver della stampante difficili da prevedere durante la scrittura di un'applicazione. La chiamata a questa funzione da un thread che gestisce l'interazione con l'interfaccia utente potrebbe rendere l'applicazione non rispondente.

Requisiti

Requisito Valore
Client minimo supportato
Windows 2000 Professional [solo app desktop]
Server minimo supportato
Windows 2000 Server [solo app desktop]
Intestazione
Winspool.h (include Windows.h)
Libreria
Winspool.lib
DLL
Winspool.drv
Nomi Unicode e ANSI
ResetPrinterW (Unicode) e ResetPrinterA (ANSI)

Vedi anche

Stampa

Funzioni dell'API spooler di stampa

OpenPrinter

PRINTER_DEFAULTS

StartDocPrinter

SetJob