IPrintOemUI2：：HideStandardUI 方法 (prcomoem.h)

项目
08/07/2023

方法 IPrintOemUI2::HideStandardUI 允许用户界面插件指定是应显示还是隐藏标准属性表。从 Microsoft Windows XP 开始，可以通过 Pscript5 用户界面插件实现此方法。从 Windows Vista 开始，可以通过 Unidrv 用户界面插件实现此方法。

语法

HRESULT HideStandardUI(
  DWORD dwMode
);

参数

dwMode

指定要隐藏的属性表 UI 类型（文档属性表或设备属性表）。此参数应设置为以下常量之一，这些常量在 printoem.h 中定义：

值	含义
OEMCUIP_DOCPROP	隐藏标准文档属性表 UI。
OEMCUIP_PRNPROP	隐藏标准设备属性表 UI。

返回值

成功后，此方法应返回S_OK。否则，它应返回E_NOTIMPL。有关其他信息，请参阅备注。

注解

此方法在 Windows Vista for Pscript 5 和 Unidrv 插件中受支持，在 Windows XP 中仅支持 Pscript5 插件。

当 pPSUIInfo-->Reason 设置为 PROPSHEETUI_REASON_INIT 时，在 DrvDocumentPropertySheets 或 DrvDevicePropertySheets DDI 中，驱动程序调用 IPrintOemUI2::HideStandardUI 方法以请求 UI 插件有关用户界面请求。此方法可以通过以下四种方式之一进行响应：

隐藏标准文档属性表 UI。
隐藏标准设备属性表 UI。
隐藏所有标准属性表 UI。
不要隐藏任何标准属性表 UI。

下表总结了方法在上述每种情况下的响应方式 IPrintOemUI2::HideStandardUI 。

指示此响应...	IPrintOemUI2：：HideStandardUI 返回...
隐藏标准文档属性表 UI。插件实现其自己的文档属性表 UI。	如果 dwMode == OEMCUIP_DOCPROP，则返回 S_OK;否则返回E_NOTIMPL。
隐藏标准设备属性表 UI。插件实现自己的设备属性表 UI。	如果 dwMode == OEMCUIP_PRNPROP，则返回 S_OK;否则返回E_NOTIMPL。
隐藏所有标准属性表 UI。插件实现自己的文档属性表和设备属性表 UI。	返回S_OK，而不考虑 dwMode 的值。
显示所有标准属性表 UI。	返回E_NOTIMPL，而不考虑 dwMode 的值。

IPrintOemUI2::HideStandardUI如果方法向驱动程序指示应隐藏所有标准属性表，则驱动程序会省略对 compstui.dll (请参阅 Pscript 组件) 添加标准属性表的调用。如果 IPrintOemUI2::HideStandardUI 返回S_OK，UI 插件必须实现至少一个自定义属性表 UI。

当打印机安装了多个 UI 插件时，驱动程序会按其安装顺序调用 UI 插件，直到其中一个插件返回S_OK，或者直到调用了所有 UI 插件，并且其中没有任何S_OK返回。前一种情况向驱动程序指示应隐藏标准属性表 UI。后一种情况向驱动程序指示应显示标准属性表 UI。