Fonction DrvUpgradePrinter (winddiui.h)

  • Article

La fonction DrvUpgradePrinter d’une DLL d’imprimante est utilisée pour mettre à jour les paramètres du Registre d’une imprimante lorsqu’une nouvelle version du pilote est ajoutée à un système.

Syntaxe

BOOL DrvUpgradePrinter(
                 DWORD  Level,
  [in, optional] LPBYTE pDriverUpgradeInfo
);

Paramètres

Level

Valeur fournie par l’appelant indiquant le type de structure pointé par pDriverUpgradeInfo, comme indiqué dans le tableau suivant.

Valeur de niveau Structure pointée par pDriverUpgradeInfo
1 DRIVER_UPGRADE_INFO_1
2 DRIVER_UPGRADE_INFO_2

[in, optional] pDriverUpgradeInfo

Pointeur fourni par l’appelant vers une structure dont le type est identifié par dwLevel.

Valeur retournée

Si l’opération réussit, la fonction doit retourner TRUE ; Sinon, il doit appeler SetLastError pour définir un code d’erreur et retourner FALSE.

Remarques

Une DLL d’interface d’imprimante peut éventuellement fournir une fonction DrvUpgradePrinter . Si c’est le cas, le spouleur l’appelle pour chaque imprimante lorsque le pilote d’imprimante est copié sur le système. Cela se produit lorsqu’un système est mis à niveau d’une version de système d’exploitation à la suivante, ou lorsqu’une application met à jour un pilote d’imprimante en appelant la fonction Win32 AddPrinterDriver .

Souvent, une nouvelle version de pilote nécessite des paramètres de Registre différents de ceux de l’ancienne version. L’objectif de la fonction DrvUpgradePrinter est de mettre à jour le Registre afin qu’il soit compatible avec le pilote. Pour plus d’informations sur le stockage des informations d’imprimante dans le Registre, consultez DrvPrinterEvent.

Pour Windows 2000 et versions ultérieures, lorsque le spouleur appelle DrvUpgradePrinter, il fournit un pointeur de structure DRIVER_UPGRADE_INFO_2 pour pDriverUpgradeInfo. Si la fonction retourne FALSE, le spouleur appelle à nouveau la fonction, en spécifiant cette fois un pointeur de structure DRIVER_UPGRADE_INFO_1. Si cet appel retourne FALSE, le spouleur écrit une entrée dans le journal des événements.

Pour Windows NT 4.0 et versions antérieures, lorsque le spouleur appelle DrvUpgradePrinter, il fournit un pointeur de structure DRIVER_UPGRADE_INFO_1 pour pDriverUpgradeInfo. Si la fonction retourne FALSE, le spouleur écrit une entrée dans le journal des événements.

Configuration requise

Condition requise Valeur
Plateforme cible Desktop (Expérience utilisateur)
En-tête winddiui.h (incluez Winddiui.h)

Voir aussi

DRIVER_UPGRADE_INFO_1

DRIVER_UPGRADE_INFO_2

DrvPrinterEvent