2.2.1.3.3 JOB_INFO Members

This section describes members commonly used in JOB_INFO structures.

pMachineName: This member is a pointer to a string that specifies the name of a server that hosts a printer. For rules governing server names, see section 2.2.4.16.

pUserName: An optional pointer to a string that specifies the name of a user that owns a print job. For rules governing user names, see section 2.2.4.17.

pNotifyName: An optional pointer to a string that specifies the name of a user to be notified when a job is complete or when an error occurs while printing a job. For rules governing user names, see section 2.2.4.17.

pDocument: An optional pointer to a string that specifies the name of a print job.

pDatatype: This member is a pointer to a string that specifies the type of data that a printing application sends to a printer in a print job. The identified data type MUST be supported by the print processor that is associated with the printer that is processing the job. For rules governing data type names, see section 2.2.4.2.

pPrintProcessor: This member is a pointer to a string that specifies the name of a print processor that is used to print a job. For rules governing print processor names, see section 2.2.4.11.

pParameters: An optional pointer to a string that specifies default print processor parameters.

pDriverName: An optional pointer to a string that specifies the name of a printer driver to process a print job. For rules governing printer driver names, see section 2.2.4.3.

pDevMode: An optional pointer to a truncated DEVMODE structure (section 2.2.1.1.1) and MUST be ignored on receipt. Actual DEVMODE data is passed to a method via a custom-marshaled _DEVMODE structure (section 2.2.2.1) in a DEVMODE_CONTAINER (section 2.2.1.2.1).

pSecurityDescriptor: An optional pointer to a SECURITY_DESCRIPTOR structure ([MS-DTYP] section 2.4.6) and MUST be ignored on receipt. Actual SECURITY_DESCRIPTOR data is passed to a method via a self-relative SECURITY_DESCRIPTOR structure in a SECURITY_CONTAINER (section 2.2.1.2.13).

JobId: This member contains an identifier for a print job.

pStatus: An optional pointer to a string that describes job status. The text is implementation-specific and can be displayed to the user, but it MUST NOT have any other functional effect. An example of job status is "Cannot print - Black ink must be replaced."

Status: This member specifies job status. The value of this member is the result of a bitwise OR of zero or more of the job status values defined in section 2.2.3.12.

Client applications can display the job status to a user. It is an implementation-specific string and SHOULD support all job status descriptions specified in section 2.2.3.12 for all corresponding status bits. If pStatus is not NULL, the string that is pointed to by pStatus SHOULD be displayed instead.

Priority: This member specifies information about job priority as a decimal number from 0 through 99, inclusive.

Position: This member specifies a job's position in a queue, where one represents the next job that is printed.

TotalPages: This member specifies the number of pages a document contains. It can be zero.

PagesPrinted: This member specifies the number of pages that have been printed. It can be zero.

Submitted: This member is a SYSTEMTIME structure ([MS-DTYP] section 2.3.13) that specifies when a document was spooled.

StartTime: This member specifies the earliest time that a printer can print a job. The time is expressed as the number of minutes after 12:00 AM GMT within a 24-hour boundary.

UntilTime: This member specifies the latest time that the printer can print a job. The time is expressed as the number of minutes after 12:00 AM GMT within a 24-hour boundary.

Size: This member specifies the size of a job, in bytes.

Time: This member specifies the number of milliseconds that have elapsed since printing began.