Funzione DrvUpgradePrinter (winddiui.h)

  • Articolo

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)

Vedi anche

DRIVER_UPGRADE_INFO_1

DRIVER_UPGRADE_INFO_2

DrvPrinterEvent