Funzione DeletePrinter

La funzione DeletePrinter elimina l'oggetto stampante specificato.

Sintassi

BOOL DeletePrinter(
  _Inout_ HANDLE hPrinter
);

Parametri

hPrinter [in, out]

Handle per un oggetto stampante che verrà eliminato. Utilizzare la funzione OpenPrinter o AddPrinter per recuperare un handle della stampante.

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à di restituzione di questa funzione 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. Chiamando questa funzione da un thread che gestisce l'interazione con l'interfaccia utente, l'applicazione potrebbe sembrare non rispondente.

Se sono presenti processi di stampa rimanenti da elaborare per la stampante specificata, DeletePrinter contrassegna la stampante per l'eliminazione in sospeso e quindi la elimina quando tutti i processi di stampa sono stati stampati. Non è possibile aggiungere processi di stampa a una stampante contrassegnata per l'eliminazione in sospeso.

Non è possibile conservare una stampante contrassegnata per l'eliminazione in sospeso, ma i processi di stampa possono essere mantenuti, ripresi e riavviati. Se la stampante viene mantenuta e sono presenti processi per la stampante, DeletePrinter ha esito negativo con ERROR_ACCESS_DENIED.

Si noti che DeletePrinter non chiude l'handle passato. Pertanto, l'applicazione deve comunque chiamare ClosePrinter.

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	Spoolss.dll

Vedi anche

Stampa

Funzioni dell'API spooler di stampa

Addprinter

Enumprinters

OpenPrinter