Funzione DeletePrinterData

La funzione DeletePrinterData elimina i dati di configurazione specificati per una stampante. I dati di configurazione di una stampante sono costituiti da un set di valori denominati e tipizzati. La funzione DeletePrinterData elimina uno di questi valori, specificato dal nome del valore.

La chiamata a DeletePrinterData equivale a chiamare la funzione DeletePrinterDataEx con il parametro pKeyName impostato su "PrinterDriverData".

Sintassi

DWORD DeletePrinterData(
  _In_ HANDLE hPrinter,
  _In_ LPTSTR pValueName
);

Parametri

hPrinter [in]

Handle per la stampante i cui dati di configurazione devono essere eliminati. Utilizzare la funzione OpenPrinter o AddPrinter per recuperare un handle della stampante.

pValueName [in]

Puntatore al nome con terminazione Null del valore dei dati di configurazione da eliminare.

Valore restituito

Se la funzione ha esito positivo, il valore restituito viene ERROR_SUCCESS.

Se la funzione ha esito negativo, il valore restituito è un codice di errore di sistema.

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.

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	DeletePrinterDataW (Unicode) e DeletePrinterDataA (ANSI)

Vedi anche

Stampa

Funzioni dell'API spooler di stampa

EnumPrinterData

GetPrinterData

OpenPrinter

Setprinter

SetPrinterData