Méthode IPrintOemUI ::UpgradePrinter (prcomoem.h)

Article
02/26/2024

La IPrintOemUI::UpgradePrinter méthode 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 retournée

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

Code de retour	Description
S_OK	L’opération a réussi.
E_FAIL	L'opération a échoué.
E_NOTIMPL	Cette méthode n'est pas implémentée.

Remarques

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

La méthode d’un IPrintOemUI::UpgradePrinter 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 IPrintOemUI::UpgradePrinter méthode .

Si IPrintOemUI::UpgradePrinter les 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’imprimante de Microsoft.

Configuration requise

Condition requise	Valeur
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	prcomoem.h (include Prcomoem.h)

Partager via