Funzione DeletePrinterDriver

La funzione DeletePrinterDriver rimuove il nome del driver della stampante specificato dall'elenco dei nomi dei driver supportati in un server.

Per eliminare i file associati al driver oltre a rimuovere il nome del driver stampante specificato dall'elenco dei nomi dei driver supportati per un server, usare la funzione DeletePrinterDriverEx .

DeletePrinterDriver elimina un driver solo se non viene usata alcuna versione del driver per l'ambiente specificato. DeletePrinterDriverEx può eliminare versioni specifiche del driver.

Sintassi

BOOL DeletePrinterDriver(
  _In_ LPTSTR pName,
  _In_ LPTSTR pEnvironment,
  _In_ LPTSTR pDriverName
);

Parametri

pName [in]

Puntatore a una stringa con terminazione null che specifica il nome del server da cui deve essere eliminato il driver. Se questo parametro è NULL, il nome del driver della stampante verrà rimosso in locale.

pEnvironment [in]

Puntatore a una stringa con terminazione null che specifica l'ambiente da cui eliminare il driver, ad esempio Windows x86, Windows IA64 o Windows x64. Se questo parametro è NULL, il nome del driver viene eliminato dall'ambiente corrente dell'applicazione chiamante e del computer client (non dell'applicazione di destinazione e del server di stampa).

pDriverName [in]

Puntatore a una stringa con terminazione null che specifica il nome del driver che deve essere eliminato.

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.

Il chiamante deve avere SeLoadDriverPrivilege.

La funzione DeletePrinterDriver non elimina i file associati, rimuove semplicemente il nome del driver dall'elenco restituito dalla funzione EnumPrinterDrivers .

Prima di chiamare DeletePrinterDriver, è necessario eliminare tutti gli oggetti stampante che usano il driver della stampante.

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	DeletePrinterDriverW (Unicode) e DeletePrinterDriverA (ANSI)

Vedi anche

Stampa

Funzioni dell'API spooler di stampa

DeletePrinterDriverEx

EnumPrinterDrivers