BOOL EnumJobs( HANDLE hPrinter, /* handle of printer object */ DWORD dwFirstJob, /* location of first job in print queue */ DWORD dwNoJobs, /* number of jobs to enumerate */ DWORD dwLevel, /* structure level */ LPBYTE lpbJob, /* address of structure array */ DWORD dwBuf, /* size of array, in bytes */ LPDWORD lpdwNeeded /* addr. of variable with no. of bytes copied */ /* (or required) */ LPDWORD lpdwReturned /* addr. of variable with no. of job info */ /* structures copied */ );
Initializes an array of either JOB_INFO_1 or JOB_INFO_2 structures with data describing the specified print jobs for the specified printer.
hPrinter | Identifies a printer object. |
dwFirstJob | Specifies the location of the first enumerated job in the print queue. For example, a value of 10 indicates that enumeration should begin at the tenth job. |
dwNoJobs | Specifies the total number of print jobs to enumerate. |
dwLevel | 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. |
lpbJob | Points to an array of either JOB_INFO_1 or JOB_INFO_2 structures. |
dwBuf | Specifies the size, in bytes, of the array pointed to by lpbJob. |
lpdwNeeded | Points to a value that specifies the number of bytes copied if the function succeeds; otherwise, this value specifies the number of bytes required. |
lpdwReturned | Points to a value that specifies the number of JOB_INFO_1 or JOB_INFO_2 structures that were initialized. |
The handle hPrinter is obtained by calling the OpenPrinter function.
The JOB_INFO_1 structure contains general print-job data; the JOB_INFO_2 structure is much more detailed.