Prev Next

JOB_INFO_1 info  Overview  Group

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
Points to a null-terminated string that specifies the name of the printer for which the job is spooled.
pMachineName
Points to a null-terminated string that specifies the name of the machine that created the print job.
pUserName
Points to a null-terminated string that specifies the name of the user that owns the print job.
pDocument
Points to a null-terminated string that specifies the name of the print job (for example, “MS-WORD: Review.doc”).
pDatatype
Points to a null-terminated string that specifies the type of data used to record the print job.
pStatus
Points 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.

See Also

EnumJobs, GetJob, SetJob