|
Overview |
|
|
|
Group |
|
|
|
Quick Info
Windows NT
| Yes
| Win95
| Yes
| Win32s
| No
| Import Library
| winspool.lib
| Header File
| winspool.h
| Unicode
| WinNT
| Platform Notes
| None
|
|
|
EnumJobs
The EnumJobs function initializes an array of either JOB_INFO_1 or JOB_INFO_2 structures with data describing the specified print jobs for the specified
printer.
BOOL EnumJobs(
HANDLE hPrinter,
| // handle to printer object
| DWORD FirstJob,
| // location of first job in print queue to enumerate
| DWORD NoJobs,
| // number of jobs to enumerate
| DWORD Level,
| // structure level
| LPBYTE pJob,
| // pointer to structure array
| DWORD cbBuf,
| // size of array, in bytes
| LPDWORD pcbNeeded,
| // addr. of variable with no. of bytes copied (or required)
| LPDWORD pcReturned
| // addr. of variable with no. of job info. structures copied
| );
|
|
Parameters
hPrinter
Handle to the printer object whose print jobs the function will enumerate.
FirstJob
Specifies the zero-based position within the print queue of the first print
job to enumerate. For example, a value of 0 specifies that enumeration should
begin at the first print job in the print queue; a value of 9 specifies that
enumeration should begin at the tenth print job in the print queue.
NoJobs
Specifies the total number of print jobs to enumerate.
Level
Specifies whether the function should use JOB_INFO_1 or JOB_INFO_2 structures to store data for the enumerated jobs. A value of 1 specifies that
the JOB_INFO_1 structure should be used; a value of 2 specifies that the JOB_INFO_2 structure should be used.
pJob
Points to an array of either JOB_INFO_1 or JOB_INFO_2 structures.
cbBuf
Specifies the size, in bytes, of the array pJob.
pcbNeeded
Points to a variable that receives the number of bytes copied if the function
succeeds. If the function fails, the variable receives the number of bytes
required.
pcReturned
Points to a variable that receives the number of JOB_INFO_1 or JOB_INFO_2 structures that were initialized.
Return Values
If the function succeeds, the return value is nonzero.
If the function fails, the return value is zero. To get extended error
information, call GetLastError.
Remarks
The handle hPrinter is obtained by calling the OpenPrinter function.
The JOB_INFO_1 structure contains general print-job information; the JOB_INFO_2 structure has much more detailed information.
See Also
GetJob, JOB_INFO_1, JOB_INFO_2, OpenPrinter, SetJob
Related Links
Software for Delphi and C++ Builder developers
Software for Visual Studio .NET developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET
TMS Scripter Studio Pro components for Delphi/C++Builder
More Online Helps
Win32 Multimedia Programmer's Reference (mmedia.hlp)
OLE Programmer's Reference (ole.hlp)
Microsoft Windows Pen API Programmer's Reference (penapi.hlp)
Microsoft Windows Sockets 2 Reference (sock2.hlp)
Microsoft Windows Telephony API (TAPI) Programmer's Reference (tapi.hlp)
Unix Manual Pages
|
