IPrintOemUI2：：HideStandardUI 方法（prcomoem.h）

项目
02/07/2025

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 时 DrvDocumentPropertySheets 或 DrvDevicePropertySheets DDI-->Reason 设置为 PROPSHEETUI_REASON_INIT，驱动程序调用 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 插件，并且没有返回任何 UI 插件S_OK。前一种情况向驱动程序指示应隐藏标准属性表 UI。后一种情况向驱动程序指示应显示标准属性表 UI。