Funzione DrvUpgradePrinter (winddiui.h)
Una DLL dell'interfaccia della stampante drvUpgradePrinter funzione viene usata per aggiornare le impostazioni del Registro di sistema di una stampante quando viene aggiunta una nuova versione del driver a un sistema.
Sintassi
BOOL DrvUpgradePrinter(
DWORD Level,
[in, optional] LPBYTE pDriverUpgradeInfo
);
Parametri
Level
Valore fornito dal chiamante che indica il tipo di struttura a cui punta pDriverUpgradeInfo, come indicato nella tabella seguente.
| valore di livello | Struttura a cui punta pDriverUpgradeInfo |
|---|---|
| 1 | DRIVER_UPGRADE_INFO_1 |
| 2 | DRIVER_UPGRADE_INFO_2 |
[in, optional] pDriverUpgradeInfo
Puntatore fornito dal chiamante a una struttura il cui tipo è identificato da dwLevel.
Valore restituito
Se l'operazione ha esito positivo, la funzione deve restituire TRUE; in caso contrario, deve chiamare SetLastError per impostare un codice di errore e restituire FALSE.
Osservazioni
Una DLL dell'interfaccia della stampante può fornire facoltativamente una funzione DrvUpgradePrinter. In caso affermativo, lo spooler lo chiama per ogni stampante quando il driver della stampante viene copiato nel sistema. Ciò si verifica quando un sistema viene aggiornato da una versione del sistema operativo alla successiva oppure quando un'applicazione aggiorna un driver della stampante chiamando la funzione Win32 AddPrinterDriver.
Spesso, una nuova versione del driver richiede impostazioni del Registro di sistema diverse da quelle della versione precedente. Lo scopo della DrvUpgradePrinter funzione è aggiornare il Registro di sistema in modo che sia compatibile con il driver. Per altre informazioni sull'archiviazione delle informazioni sulla stampante nel Registro di sistema, vedere DrvPrinterEvent.
Per Windows 2000 e versioni successive, quando lo spooler chiama DrvUpgradePrinter, fornisce un puntatore alla struttura DRIVER_UPGRADE_INFO_2 per pDriverUpgradeInfo. Se la funzione restituisce FALSE, lo spooler chiama nuovamente la funzione, questa volta specificando un puntatore alla struttura DRIVER_UPGRADE_INFO_1. Se questa chiamata restituisce FALSE, lo spooler scrive una voce nel registro eventi.
Per Windows NT 4.0 e versioni precedenti, quando lo spooler chiama DrvUpgradePrinter, fornisce un puntatore alla struttura DRIVER_UPGRADE_INFO_1 per pDriverUpgradeInfo. Se la funzione restituisce FALSE, lo spooler scrive una voce nel registro eventi.
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Desktop |
| intestazione | winddiui.h (include Winddiui.h) |