Prev Next
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