Funzione UpdatePrintDeviceObject (winsplp.h)

Avviso

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 Windows 8 e nei prodotti più recenti 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 spooler AddPrinter o OpenPrinter .

[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.

Commenti

La struttura PRINTER_INFO_2 è un buon esempio del tipo di proprietà che UpdatePrintDeviceObject può aggiornare.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Desktop
Intestazione	winsplp.h (include Winspool.h)
Libreria	WinSpool.lib
DLL	WinSpool.drv

Vedi anche

AddPrintDeviceObject

PRINTER_INFO_2