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