IPrintOemUI::UpdateExternalFonts-Methode (prcomoem.h)

Die IPrintOemUI::UpdateExternalFonts -Methode ermöglicht es einem Benutzeroberflächen-Plug-In, die Unidrv-Schriftformatdateien (uff-Datei) eines Druckers zu aktualisieren.

Syntax

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

Parameter

hPrinter

Vom Anrufer bereitgestellter Druckerhandle.

hHeap

Vom Aufrufer bereitgestelltes Handle zum Heapspeicher, den die Methode für den lokalen Speicher verwenden kann.

pwstrCartridges

Vom Aufrufer bereitgestellter Zeiger auf ein Array von Zeichenfolgen, die die Namen aller derzeit auf dem Drucker installierten Patronen darstellen.

Rückgabewert

Die -Methode muss einen der folgenden Werte zurückgeben.

Rückgabecode	BESCHREIBUNG
S_OK	Der Vorgang wurde erfolgreich ausgeführt.
E_FAIL	Fehler beim Vorgang.
E_NOTIMPL	Die Methode ist nicht implementiert.

Hinweise

Ein Benutzeroberflächen-Plug-In muss die IPrintOemUI::UpdateExternalFonts -Methode implementieren, wenn das Plug-In das Standardschriftinstallationsprogramm von Unidrv ersetzt. Weitere Informationen finden Sie unter Angepasste Schriftartinstallationsprogramme für Unidrv.

Der IPrintOemUI::UpdateExternalFonts Zweck der Methode besteht darin, die Liste der installierten Patronen (von pwstrCartridges bereitgestellt) zu untersuchen und sicherzustellen, dass die durch den Registrierungswert "ExternalFontFile" angegebene .uff-Datei nur Schriftbeschreibungen für die in den installierten Patronen enthaltenen Patronenschriftarten enthält. (Diese UFF-Datei kann auch Beschreibungen von PCL-herunterladbaren Softfonts enthalten.)

Beschreibungen von Patronenschriftarten können aus der uff-Datei kopiert werden, die durch den Registrierungswert "ExtFontCartFile" angegeben wird. Weitere Informationen finden Sie unter Unidrv Font Format Files.

Anforderungen

Anforderung	Wert
Zielplattform	Desktop
Kopfzeile	prcomoem.h (include Prcomoem.h)

Weitere Informationen

IPrintOemUI

IPrintOemUI::FontInstallerDlgProc