Funzione UpdatePrintDeviceObject (winsplp.h)
Avvertimento
A partire da Windows 10, le API che supportano provider di stampa di terze parti sono deprecate. Microsoft non consiglia alcun investimento in provider di stampa di terze parti. Inoltre, nei prodotti Windows 8 e versioni successive in cui è disponibile il modello di driver di stampa v4, i provider di stampa di terze parti potrebbero non creare o gestire code che usano driver di stampa v4.
La funzione UpdatePrintDeviceObject aggiorna le proprietà di un oggetto dispositivo presente nella coda del provider di stampa.
Sintassi
HRESULT UpdatePrintDeviceObject(
[in] HANDLE hPrinter,
[in] HANDLE hDeviceObject
);
Parametri
[in] hPrinter
Handle di una stampante aperta. Deve trattarsi di un handle restituito dalle funzioni AddPrinter o OpenPrinter spooler.
[in] hDeviceObject
Handle per l'oggetto dispositivo da aggiornare. Deve trattarsi di un oggetto dispositivo creato con AddPrintDeviceObject.
Valore restituito
La funzione UpdatePrintDeviceObject restituisce S_OK, se le proprietà dell'oggetto dispositivo sono state aggiornate correttamente. In caso contrario, restituisce un errore.
Ad esempio, questa funzione può restituire HRESULT_FROM_WIN32(ERROR_INVALID_HANDLE), se la chiamata di funzione è stata effettuata con un HANDLE non valido o l'oggetto dispositivo è stato rimosso prima che sia stata effettuata la chiamata di funzione.
Osservazioni
La struttura PRINTER_INFO_2 è un buon esempio del tipo di proprietà che è possibile aggiornare UpdatePrintDeviceObject.
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Desktop |
| intestazione | winsplp.h (include Winspool.h) |
| libreria | WinSpool.lib |
| dll | WinSpool.drv |