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 (include Prcomoem.h)