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

La IPrintOemUI::UpdateExternalFonts méthode permet à un plug-in d’interface utilisateur de mettre à jour les fichiers de format de police Unidrv d’une imprimante (fichier .uff).

Syntaxe

HRESULT UpdateExternalFonts(
  HANDLE hPrinter,
  HANDLE hHeap,
  PWSTR  pwstrCartridges
);

Paramètres

hPrinter

Poignée d’imprimante fournie par l’appelant.

hHeap

Handle fourni par l’appelant pour la mémoire du tas que la méthode peut utiliser pour le stockage local.

pwstrCartridges

Pointeur fourni par l’appelant vers un tableau de chaînes représentant les noms de toutes les cartouches actuellement installées sur l’imprimante.

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

Un plug-in d’interface utilisateur doit implémenter la IPrintOemUI::UpdateExternalFonts méthode si le plug-in remplace le programme d’installation de police par défaut d’Unidrv. Pour plus d’informations, consultez Programmes d’installation de polices personnalisés pour Unidrv.

L’objectif IPrintOemUI::UpdateExternalFonts de la méthode est d’examiner la liste des cartouches installées (fournie par pwstrCartridges) et de s’assurer que le fichier .uff spécifié par la valeur de Registre « ExternalFontFile » contient des descriptions de polices pour uniquement les polices de cartouche contenues dans les cartouches installées. (Ce fichier .uff peut également contenir des descriptions de polices logicielles téléchargeables par PCL.)

Les descriptions des polices de cartouche peuvent être copiées à partir du fichier .uff spécifié par la valeur de Registre « ExtFontCartFile ». Pour plus d’informations, consultez Unidrv Font Format Files.

Configuration requise

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

Voir aussi

IPrintOemUI

IPrintOemUI ::FontInstallerDlgProc