GetSpoolFileHandle 函数

GetSpoolFileHandle 函数检索与应用程序当前提交的作业关联的假脱机文件的句柄。

语法

HANDLE GetSpoolFileHandle(
  _In_ HANDLE hPrinter
);

parameters

hPrinter [in]

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

返回值

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

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

备注

使用后台处理程序文件的句柄,应用程序可以通过调用 WriteFileCommitSpoolData 写入后台处理程序文件。

应用程序在最后一次访问后台处理程序文件之前,不得在 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