OpenPrintProcessor 函数 (winsplp.h)

打印处理器的 OpenPrintProcessor 函数为打印作业准备打印处理器,并返回句柄。

语法

HANDLE OpenPrintProcessor(
  [in] LPWSTR                  pPrinterName,
  [in] PPRINTPROCESSOROPENDATA pPrintProcessorOpenData
);

参数

[in] pPrinterName

调用方提供的指针,指向要为其打开打印处理器的打印机的名称。

[in] pPrintProcessorOpenData

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

返回值

如果操作成功,函数应返回一个句柄,该句柄可用作对 PrintDocumentOnPrintProcessorControlPrintProcessor 和 ClosePrintProcessor 的后续调用的输入参数。 如果操作失败,函数应调用 SetLastError 来设置错误代码,然后返回 NULL

注解

导出 OpenPrintProcessor 函数需要打印处理器。 打印作业可用时,后台处理程序将调用 函数。 函数应根据作业的数据类型执行在处理作业之前所需的初始化操作。

函数必须返回句柄。 通常,句柄是指向内部结构的指针。 结构必须包含指向打印机名称的指针和指向打印机的 DEVMODEW 结构的指针,这两者都在 PRINTPROCESSOROPENDATA 结构中接收。 打印处理器的 PrintDocumentOnPrintProcessor 函数需要这两个指针,后一个函数在后台处理程序调用它时接收句柄作为输入。

要求

要求
目标平台 桌面
标头 winsplp.h (包括 Winsplp.h)
Library Nwprint.lib

另请参阅

ClosePrintProcessor

ControlPrintProcessor

PRINTPROCESSOROPENDATA

PrintDocumentOnPrintProcessor