Funzione DrvUpgradePrinter (winddiui.h)
La funzione DrvUpgradePrinter di una DLL dell'interfaccia della stampante 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 fa riferimento pDriverUpgradeInfo, come indicato nella tabella seguente.
| Valore livello | Struttura a cui fa riferimento 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.
Commenti
Una DLL dell'interfaccia della stampante può fornire facoltativamente una funzione DrvUpgradePrinter . In caso contrario, 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 AddPrinterDriver Win32.
Spesso, una nuova versione del driver richiede impostazioni del Registro di sistema diverse da quelle della versione precedente. Lo scopo della funzione DrvUpgradePrinter è 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 il spooler chiama DrvUpgradePrinter, fornisce un puntatore della struttura DRIVER_UPGRADE_INFO_2 per pDriverUpgradeInfo. Se la funzione restituisce FALSE, lo spooler chiama di nuovo la funzione, questa volta specificando un puntatore della struttura DRIVER_UPGRADE_INFO_1. Se questa chiamata restituisce FALSE, il spooler scrive una voce nel registro eventi.
Per Windows NT 4.0 e versioni precedenti, quando il spooler chiama DrvUpgradePrinter, fornisce un puntatore della struttura DRIVER_UPGRADE_INFO_1 per pDriverUpgradeInfo. Se la funzione restituisce FALSE, lo spooler scrive una voce nel registro eventi.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Desktop |
| Intestazione | winddiui.h (include Winddiui.h) |