OpenPrintProcessor 函数（winsplp.h）

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

语法

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

参数

[in] pPrinterName

调用方提供的指针指向正在打开打印处理器的打印机的名称。

[in] pPrintProcessorOpenData

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

返回值

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

言论

导出 OpenPrintProcessor 函数需要打印处理器。打印作业可用时，后台处理程序将调用函数。该函数应根据作业的数据类型执行所需的初始化作，然后才能处理作业。

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