IPrintOemDriverUI::D rvUpdateUISetting 方法 (prcomoem.h)

方法 IPrintOemDriverUI::DrvUpdateUISetting 由 Unidrv 和 Pscript5 微型驱动程序提供,以便用户界面插件可以通知驱动程序已修改的用户界面选项。

语法

HRESULT DrvUpdateUISetting(
  PVOID pci,
  PVOID pOptItem,
  DWORD dwPreviousSelection,
  DWORD dwMode
);

参数

pci

调用方提供的指向 OEMUIOBJ 结构的指针。

pOptItem

调用方提供的指向描述用户界面选项项的 OPTITEM 结构的指针。

dwPreviousSelection

未使用。

dwMode

调用方提供的整数常量,指示提供的选项项所属的属性表页。 以下常量有效。

定义
OEMCUIP_DOCPROP 提供的选项项属于文档属性表的“高级”页。
OEMCUIP_PRNPROP 提供的选项项属于打印机属性表的“设备设置”页。
 

有关更多信息,请参见下面的“备注”部分。

返回值

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

返回代码 说明
S_OK
操作成功。
E_FAIL
此操作失败。
E_NOTIMPL
该方法未实现。

注解

如果要提供实现 IPrintOemUI::D ocumentPropertySheets 方法或 IPrintOemUI::D evicePropertySheets 方法的用户界面插件,通常还会提供 _CPSUICALLBACK类型的回调函数来处理用户修改。 如果值存储在驱动程序的 DEVMODEW 结构 (而不是插件的专用 DEVMODEW 成员 ) 或注册表项中,则此回调函数必须调用 IPrintOemDriverUI::DrvUpdateUISetting 以在修改与用户界面设置关联的值时通知驱动程序。

dwMode 指定的值应基于指定回调函数的方法。

要求

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