IPrintOemUI::D evQueryPrintEx 方法(prcomoem.h)

IPrintOemUI::DevQueryPrintEx 方法允许用户界面插件帮助确定打印作业是否可打印。

语法

HRESULT DevQueryPrintEx(
  POEMUIOBJ           poemuiobj,
  PDEVQUERYPRINT_INFO pDQPInfo,
  PDEVMODE            pPublicDM,
  PVOID               pOEMDM
);

参数

poemuiobj

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

pDQPInfo

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

pPublicDM

调用方提供的指向已验证的 DEVMODEW 结构的指针。

pOEMDM

调用方提供的指向用户界面插件的专用 DEVMODEW 结构成员的指针。

返回值

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

返回代码 描述
S_OK
作成功。
E_FAIL
作失败。
E_NOTIMPL
未实现该方法。

言论

用户界面插件的 IPrintOemUI::DevQueryPrintEx 方法执行与用户模式打印机接口 DLL 导出的 DevQueryPrintEx 函数相同的作类型。 可以使用此方法增强 DevQueryPrintEx 函数提供的功能。 与 DevQueryPrintEx 函数一样,IPrintOemUI::DevQueryPrintEx 方法的责任是确定是否可以打印提供的 DEVMODEW 结构描述的打印作业。

调用驱动程序的 DevQueryPrintEx 函数时,它会检查 DEVMODEW 结构以及当前选定的打印机选项,以确定作业是否可打印。 如果不是,则函数返回 FALSE。 如果作业似乎可打印,该函数将在与驱动程序关联的每个用户界面插件中调用 IPrintOemUI::DevQueryPrintEx 方法。 如果所有 IPrintOemUI::DevQueryPrintEx 方法返回S_OK,则 DevQueryPrintEx 返回 true 。 因此,作业不可打印,除非 DevQueryPrintEx 函数,并且所有 IPrintOemUI::DevQueryPrintEx 方法都将其声明为可打印。

如果 IPrintOemUI::DevQueryPrintEx 方法由多个用户界面插件导出,则按照为安装指定插件的顺序调用这些方法。

有关创建和安装用户界面插件的详细信息,请参阅 自定义Microsoft的打印机驱动程序

要求

要求 价值
目标平台 桌面
标头 prcomoem.h (include Prcomoem.h)

另请参阅

DevQueryPrintEx