Partager via


IPrintOemUI ::UpgradePrinter, méthode (prcomoem.h)

La méthode IPrintOemUI::UpgradePrinter permet à un plug-in d’interface utilisateur de mettre à niveau les valeurs d’option d’appareil stockées dans le Registre.

Syntaxe

HRESULT UpgradePrinter(
  DWORD dwLevel,
  PBYTE pDriverUpgradeInfo
);

Paramètres

dwLevel

Numéro de version fourni par l’appelant de la structure pointée par pDriverUpgradeInfo. La valeur valide actuelle est 1.

pDriverUpgradeInfo

Pointeur fourni par l’appelant vers une structure DRIVER_UPGRADE_INFO_1.

Valeur de retour

La méthode doit retourner l’une des valeurs suivantes.

Retourner le code Description
S_OK
L’opération a réussi.
E_FAIL
L’opération a échoué.
E_NOTIMPL
La méthode n’est pas implémentée.

Remarques

Si vous fournissez un plug-in d’interface utilisateur pour l’un des pilotes d’imprimantes de Microsoft et si le plug-in d’interface utilisateur stocke les valeurs d’option d’appareil dans le Registre, il doit implémenter la méthode IPrintOemUI::UpgradePrinter pour mettre à jour ces valeurs.

La méthode IPrintOemUI::UpgradePrinter d’un plug-in d’interface utilisateur effectue les mêmes types d’opérations que la fonction DrvUpgradePrinter exportée par les DLL d’interface d’imprimante en mode utilisateur. Lorsque la fonction DrvUpgradePrinter du pilote est appelée, elle met à jour ses propres valeurs de Registre, puis appelle la méthode IPrintOemUI::UpgradePrinter.

Si IPrintOemUI::UpgradePrinter méthodes sont exportées par plusieurs plug-ins d’interface utilisateur, les méthodes sont appelées dans l’ordre dans lequel les plug-ins sont spécifiés pour l’installation.

Pour plus d’informations sur la création et l’installation de plug-ins d’interface utilisateur, consultez Personnalisation des pilotes d’imprimantes microsoft.

Exigences

Exigence Valeur
plateforme cible Bureau
d’en-tête prcomoem.h (include Prcomoem.h)