GdiGetSpoolFileHandle 函数 (winppi.h)

GdiGetSpoolFileHandle 函数返回打印作业的 EMF 文件的句柄。

语法

HANDLE GdiGetSpoolFileHandle(
  LPWSTR     pwszPrinterName,
  LPDEVMODEW pDevmode,
  LPWSTR     pwszDocName
);

参数

pwszPrinterName

调用方提供的指向表示目标打印机名称的字符串的指针。 请参阅以下“备注”部分。

pDevmode

调用方提供的指向 DEVMODEW 结构的指针。 请参阅以下“备注”部分。

pwszDocName

调用方提供的指向打印作业的文档名称的指针。 请参阅以下“备注”部分。

返回值

如果作成功,该函数将返回后台处理程序文件句柄。 否则,该函数返回 NULL

言论

GdiGetSpoolFileHandle 函数由 gdi32.dll 导出,以便在打印处理器的 PrintDocumentOnPrintProcessor 函数中使用。

当打印处理器调用 GdiGetSpoolFileHandle时,它应提供参数,如下表所示。

参数 论点
pwszPrinterName 指向打印处理器的 OpenPrintProcessor 函数收到的打印机名称的指针。
pDevmode 指向 PRINTPROCESSOROPENDATA 结构中包含的 DEVMODEW 结构的指针,该结构由打印处理器的 OpenPrintProcessor 函数接收。
pwszDocName 打印处理器的 PrintDocumentOnPrintProcessor 函数接收的文档名称指针。

打印处理器必须在调用任何其他 GDI 打印函数之前调用 GdiGetSpoolFileHandle 函数,因为返回的句柄必须传递给其他函数。 该函数调用 OpenPrinter 以打开与打印机的连接,并创建用于绘图的设备上下文。 打印处理器可以通过调用 GdiGetDC来获取设备上下文的句柄。

有关详细信息,请参阅 在打印处理器中使用 GDI 函数

要求

要求 价值
目标平台 普遍
标头 winppi.h (包括 Winppi.h)
Gdi32.Lib
DLL Gdi32.dll

另请参阅

GdiDeleteSpoolFileHandle