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 |
---|---|
|
L’opération a réussi. |
|
L’opération a échoué. |
|
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) |