勇芳软件工作室.汉化:  Printing > Print Spooler API > Print Spooler API Reference > Print Spooler API Functions >

GetSpoolFileHandle (Vista)

Previous pageReturn to chapter overviewNext page

描述

 

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

 

C++ 语法

 

HANDLE GetSpoolFileHandle(

__in HANDLE hPrinter

);

 

PowerBASIC 语法

 

FUNCTION GetSpoolFileHandle ( _

BYVAL hPrinter AS DWORD _

) AS DWORD

 

参数

 

hPrinter

 

[in]处理提交作业的打印机。这应该是用于提交作业的句柄。(使用OpenPrinterAddPrinter功能检索打印机手柄。)

 

返回值

 

如果函数成功,它将返回一个句柄到假脱机文件。

 

如果函数失败,则返回INVALID_HANDLE_VALUE。

 

备注

 

使用假脱机文件的句柄,您的应用程序可以通过调用WriteFile后跟CommitSpoolData写入假脱机文件。

 

您的应用程序不得在hPrinter上调用ClosePrinter,直到最后访问假脱机文件为止。那么它应该叫CloseSpoolFileHandle,后跟ClosePrinter.原始hPrinter已关闭后尝试访问假脱机文件句柄将失败,即使文件句柄本身未关闭。CloseSpoolFileHandle将自动失败,如果ClosePrinter被首先调用。

 

如果在打印作业完成假脱机之前调用该函数,则此函数将失败。

 

引用文件 #INCLUDE Once

 

WinSpool.inc(包括Windows.inc)