JOB_INFO_2 info  Overview  Group

The JOB_INFO_2 structure describes a full set of values associated with a job.

typedef struct _JOB_INFO_2 { // ji2 

    DWORD      JobId; 

    LPTSTR     pPrinterName; 

    LPTSTR     pMachineName; 

    LPTSTR     pUserName; 

    LPTSTR     pDocument; 

    LPTSTR     pNotifyName; 

    LPTSTR     pDatatype; 

    LPTSTR     pPrintProcessor; 

    LPTSTR     pParameters; 

    LPTSTR     pDriverName; 

    LPDEVMODE  pDevMode; 

    LPTSTR     pStatus; 

    PSECURITY_DESCRIPTOR pSecurityDescriptor; 

    DWORD      Status; 

    DWORD      Priority; 

    DWORD      Position; 

    DWORD      StartTime; 

    DWORD      UntilTime; 

    DWORD      TotalPages; 

    DWORD      Size; 

    SYSTEMTIME Submitted; 

    DWORD      Time; 

    DWORD      PagesPrinted ; 

} JOB_INFO_2; 

 

Members

JobId

Specifies a job identifier value.

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 who 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”).

pNotifyName

Points to a null-terminated string that specifies the name of the user who should be notified when the job has been printed or when an error occurs while printing the job.

pDatatype

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

pPrintProcessor

Points to a null-terminated string that specifies the name of the print processor that should be used to print the job.

pParameters

Points to a null-terminated string that specifies print-processor parameters.

pDriverName

Points to a null-terminated string that specifies the name of the printer driver that should be used to process the print job.

pDevMode

Points to a DEVMODE structure that contains device-initialization and environment data for the printer driver.

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.

pSecurityDescriptor

The value of this member is NULL. Retrieval and setting of document security descriptors is not supported in this release.

Status

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

JOB_STATUS_PAUSED
JOB_STATUS_ERROR
JOB_STATUS_DELETING
JOB_STATUS_SPOOLING
JOB_STATUS_PRINTING
JOB_STATUS_OFFLINE
JOB_STATUS_PAPEROUT
JOB_STATUS_PRINTED

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.

StartTime

Specifies the earliest time that the job can be printed.

UntilTime

Specifies the the latest time that the job can be printed.

TotalPages

Specifies the number of pages required for the job.

Size

Specifies the size, in bytes, of the job.

Submitted

Specifies the time when the job was submitted.

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.

Time

Specifies the total time, in seconds, that has elapsed since the job began printing.

PagesPrinted

Specifies the number of pages that have printed.

See Also

DEVMODE, EnumJobs, GetJob, SetJob