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