Funzione AbortDoc (wingdi.h)

Articolo
08/27/2023

La funzione AbortDoc arresta il processo di stampa corrente e cancella tutto quello disegnato dall'ultima chiamata alla funzione StartDoc .

Sintassi

int AbortDoc(
  [in] HDC hdc
);

Parametri

[in] hdc

Gestire il contesto del dispositivo per il processo di stampa.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è maggiore di zero.

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

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, ad esempio lo stato di rete, la configurazione del server di stampa e l'implementazione del driver della stampante, fattori 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.

Le applicazioni devono chiamare la funzione AbortDoc per arrestare un processo di stampa se si verifica un errore o arrestare un processo di stampa dopo l'annullamento del processo. Per terminare un processo di stampa riuscito, un'applicazione deve chiamare la funzione EndDoc .

Se Print Manager è stato usato per avviare il processo di stampa, chiamando AbortDoc cancella l'intero processo di spool, in modo che la stampante riceva nulla. Se Print Manager non è stato usato per avviare il processo di stampa, i dati potrebbero essere già stati inviati alla stampante. In questo caso, il driver della stampante reimposta la stampante (quando possibile) e termina il processo di stampa.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	wingdi.h (include Windows.h)
Libreria	Gdi32.lib
DLL	Gdi32.dll