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 |