IPrintOemUI::UpdateExternalFonts 方法 (prcomoem.h)

IPrintOemUI::UpdateExternalFonts 方法允许用户界面插件更新打印机的 Unidrv 字体格式化文件(.uff 文件)。

语法

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

参数

hPrinter

调用方提供的打印机句柄。

hHeap

调用方提供的堆内存句柄,该方法可用于本地存储。

pwstrCartridges

调用方提供的指向字符串数组的指针,这些字符串表示当前安装在打印机上的所有墨盒的名称。

返回值

该方法必须返回以下值之一。

返回代码 描述
S_OK
作成功。
E_FAIL
作失败。
E_NOTIMPL
未实现该方法。

言论

如果插件替换 Unidrv 的默认字体安装程序,用户界面插件必须实现 IPrintOemUI::UpdateExternalFonts 方法。 有关详细信息,请参阅 Unidrv的自定义字体安装程序。

IPrintOemUI::UpdateExternalFonts 方法的目的是检查已安装的墨盒列表(由 pwstrCartridges提供),并确保由“ExternalFontFile”注册表值指定的 .uff 文件仅包含已安装墨盒中包含的墨盒字体的字体说明。 (此 .uff 文件还可以包含 PCL-downloadable soft fonts 的说明。

可以从“ExtFontCartFile”注册表值指定的 .uff 文件中复制墨盒字体的说明。 有关详细信息,请参阅 Unidrv 字体格式化文件

要求

要求 价值
目标平台 桌面
标头 prcomoem.h (include Prcomoem.h)

另请参阅

IPrintOemUI

IPrintOemUI::FontInstallerDlgProc