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 可下载软字体的说明。)

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

要求

要求
目标平台 桌面
标头 prcomoem.h (包括 Prcomoem.h)

另请参阅

IPrintOemUI

IPrintOemUI::FontInstallerDlgProc