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

另请参阅

DevQueryPrintEx