GetSpoolFileHandle 函数

  • 项目

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

语法

HANDLE GetSpoolFileHandle(
  _In_ HANDLE hPrinter
);

parameters

hPrinter [in]

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

返回值

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

如果函数失败，它将返回 INVALID_HANDLE_VALUE。

备注

使用后台处理程序文件的句柄，应用程序可以通过调用 WriteFile 和 CommitSpoolData 写入后台处理程序文件。

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

如果在打印作业完成后台打印之前调用此函数，则会失败。

要求

要求 值
最低受支持的客户端
 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