GetJob

The GetJob function retrieves print-job data for the specified printer.

BOOL GetJob(
  HANDLE hPrinter,    // handle to printer
  DWORD JobId,        // job identifier value
  DWORD Level,        // data-structure level
  LPBYTE pJob,        // address of data-structure array
  DWORD cbBuf,        // count of bytes in array
  LPDWORD pcbNeeded   // address of value that contains count of 
                      // bytes retrieved (or required)
);
 

Parameters

hPrinter

Handle to the printer for which the print-job data is retrieved.

JobId

Handle to the print job for which data should be retrieved.

Level

Specifies the level of the structure to which pJob points. This value must be either 1 or 2.

pJob

Pointer to an array that contains either a JOB_INFO_1 or a JOB_INFO_2 structure. If Level is 1, this function stores the data in a JOB_INFO_1 structure; if Level is 2, this function stores the data in a JOB_INFO_2 structure.

cbBuf

Specifies the size, in bytes, of the array.

pcbNeeded

Pointer to a value that specifies the number of bytes copied if the function succeeds or the number of bytes required if cbBuf is too small.

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.

QuickInfo

  Windows NT: Requires version 3.1 or later.
  Windows: Requires Windows 95 or later.
  Windows CE: Unsupported.
  Header: Declared in winspool.h.
  Import Library: Use winspool.lib.
  Unicode: Implemented as Unicode and ANSI versions on Windows NT.

See Also

Printing and Print Spooler Overview, Printing and Print Spooler Functions, AddJob, JOB_INFO_1, JOB_INFO_2, ScheduleJob, SetJob