JOB_INFO_1

The JOB_INFO_1 structure specifies print-job information such as the job-identifier value, the name of the printer for which the job is spooled, the name of the machine that created the print job, the name of the user that owns the print job, and so on.

typedef struct _JOB_INFO_1 {    // ji1 
    DWORD  JobId; 
    LPTSTR pPrinterName; 
    LPTSTR pMachineName; 
    LPTSTR pUserName; 
    LPTSTR pDocument; 
    LPTSTR pDatatype; 
    LPTSTR pStatus; 
    DWORD  Status; 
    DWORD  Priority; 
    DWORD  Position; 
    DWORD  TotalPages; 
    DWORD  PagesPrinted; 
    SYSTEMTIME Submitted; 
} JOB_INFO_1; 
 

Members

JobId

Specifies a job identifier.

pPrinterName

Pointer to a null-terminated string that specifies the name of the printer for which the job is spooled.

pMachineName

Pointer to a null-terminated string that specifies the name of the machine that created the print job.

pUserName

Pointer to a null-terminated string that specifies the name of the user that owns the print job.

pDocument

Pointer to a null-terminated string that specifies the name of the print job (for example, "MS-WORD: Review.doc").

pDatatype

Pointer to a null-terminated string that specifies the type of data used to record the print job.

pStatus

Pointer to a null-terminated string that specifies the status of the print job. This member should be checked prior to Status and, if pStatus is NULL, the status is defined by the contents of the Status member.

Status

Specifies the job status. This member can be one or more of the following values:

JOB_STATUS_DELETING
JOB_STATUS_ERROR
JOB_STATUS_OFFLINE
JOB_STATUS_PAPEROUT
JOB_STATUS_PAUSED
JOB_STATUS_PRINTED
JOB_STATUS_PRINTING
JOB_STATUS_SPOOLING

Priority

Specifies the job priority. This member can be one of the following values or in the range between 1 through 99 (MIN_PRIORITY through MAX_PRIORITY):

Value	Meaning
MIN_PRIORITY	Minimum priority.
MAX_PRIORITY	Maximum priority.
DEF_PRIORITY	Default priority.

Position

Specifies the job's position in the print queue.

TotalPages

Specifies how many pages the document contains.

PagesPrinted

Specifies the number of pages that have printed.

Submitted

Specifies the time that this document was spooled.

This time value is in Universal Coordinated Time (UTC) format. You should convert it to a local time value before displaying it. You can use the FileTimeToLocalFileTime function to perform the conversion.

QuickInfo

  Windows NT: Requires version 3.1 or later.
  Windows: Requires Windows 95 or later.
  Windows CE: Unsupported.
  Header: Declared in winspool.h.
  Unicode: Defined as Unicode and ANSI structures.

See Also

Printing and Print Spooler Overview, Printing and Print Spooler Structures, EnumJobs, GetJob, SetJob