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 [仅限桌面应用] |
标头 |
|
库 |
|
DLL |
|
Unicode 和 ANSI 名称 |
GetSpoolFileHandleW (Unicode) 和 GetSpoolFileHandleA (ANSI) |