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 以打开与打印机的连接，并调用 CreateDC 来创建用于绘图的设备上下文。 打印处理器可以通过调用 GdiGetDC 来获取设备上下文的句柄。

有关其他信息，请参阅 在打印处理器中使用 GDI 函数。

要求

要求 值
目标平台 通用
标头 winppi.h (包括 Winppi.h)
Library Gdi32.Lib
DLL Gdi32.dll

另请参阅

GdiDeleteSpoolFileHandle