GetSpoolFileHandle 函数

GetSpoolFileHandle 函数检索与应用程序当前提交的作业关联的后台处理程序文件的句柄。

语法

HANDLE GetSpoolFileHandle(
  _In_ HANDLE hPrinter
);

参数

hPrinter [in]

作业提交到的打印机的句柄。 这应该是用于提交作业的同一句柄。 (使用 OpenPrinterAddPrinter 函数检索打印机句柄。)

返回值

如果函数成功,它将返回后台处理程序文件的句柄。

如果函数失败,它将返回 INVALID_HANDLE_VALUE

注解

使用对后台处理程序文件的句柄,应用程序可以使用对 WriteFile 的调用(后跟 CommitSpoolData)写入后台处理程序文件。

应用程序在最后一次访问后台处理程序文件之前,不得在 hPrinter 上调用 ClosePrinter。 然后,它应调用 CloseSpoolFileHandle ,后跟 ClosePrinter。 即使文件句柄本身尚未关闭,在原始 hPrinter 关闭后尝试访问后台处理程序文件句柄也会失败。 如果首先调用 ClosePrinterCloseSpoolFileHandle 本身将失败。

如果在打印作业完成后台处理之前调用此函数,此函数将失败。

要求

要求
最低受支持的客户端
Windows Vista [仅限桌面应用]
最低受支持的服务器
Windows Server 2008 [仅限桌面应用]
标头
Winspool.h (包括 Windows.h)

Winspool.lib
DLL
WinSpool.drv
Unicode 和 ANSI 名称
GetSpoolFileHandleW (Unicode) 和 GetSpoolFileHandleA (ANSI)

另请参阅

打印

打印后台处理程序 API 函数

OpenPrinter

AddPrinter

ClosePrinter

CloseSpoolFileHandle

CommitSpoolData