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 函数需要这两个指针,后一个函数在后台处理程序调用它时接收句柄作为输入。
要求
要求 | 值 |
---|---|
目标平台 | 桌面 |
标头 | winsplp.h (包括 Winsplp.h) |
Library | Nwprint.lib |
另请参阅
ClosePrintProcessor
ControlPrintProcessor
PrintDocumentOnPrintProcessor