描述
CommitSpoolData函数通知打印后台处理程序已将指定数量的数据写入指定的假脱机文件，并准备渲染。
C++ 语法
HANDLE CommitSpoolData( __in HANDLE hPrinter, __in HANDLE hSpoolFile, __in DWORD cbCommit ); |
PowerBASIC 语法
FUNCTION CommitSpoolData ( _ BYVAL hPrinter AS DWORD, _ BYVAL hSpoolFile AS DWORD, _ BYVAL cbCommit AS DWORD _ ) AS DWORD |
参数
hPrinter
[in]处理提交作业的打印机。这应该是与GetSpoolFileHandle获得hSpoolFile所使用的句柄相同的句柄。
hSpoolFile
[in]正在更改的假脱机文件的句柄。在CommitSpoolData的第一个电话中，这应该是GetSpoolFileHandle返回的句柄。对CommitSpoolData的后续调用应通过前一个调用返回的句柄。见备注.
cbCommit
[in]提交给打印后台处理程序的字节数。
返回值
如果函数成功，它将返回一个句柄到假脱机文件。
如果函数失败，则返回INVALID_HANDLE_VALUE。
备注
提交假脱机打印作业的应用程序可以调用GetSpoolFileHandle，然后直接通过调用WriteFile将数据写入假脱机文件句柄。要通知打印后台处理程序该文件包含准备渲染的数据，应用程序必须调用CommitSpoolData并提供可用字节数。
如果多次调用CommitSpoolData，则每个调用必须使用前一次调用返回的假脱机文件句柄。当没有更多的数据将被写入到假脱机文件中时，应该为CommitSpoolData的最后一次调用返回的文件句柄调用CloseSpoolFileHandle.
在调用CommitSpoolData之前，应用程序必须将文件指针设置为将文件写入文件之前的位置。在呈现假脱机程序文件中的数据的过程中，打印后台处理程序将从文件指针的当前值移动假脱机文件指针cbCommit字节。
引用文件 #INCLUDE Once
WinSpool.inc（包括Windows.inc）