структура JOB_INFO_2

Структура JOB_INFO_2 описывает полный набор значений, связанных с заданием.

Синтаксис

typedef struct _JOB_INFO_2 {
  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, *PJOB_INFO_2;

Члены

JobId

Значение идентификатора задания.

pPrinterName

Указатель на строку, завершающуюся значением NULL, которая указывает имя принтера, для которого выполняется создание задания.

pMachineName

Указатель на строку, завершающуюся нулевым значением, которая указывает имя компьютера, создавшего задание печати.

pUserName

Указатель на строку, завершающуюся значением NULL, которая указывает имя пользователя, которому принадлежит задание печати.

pDocument

Указатель на строку, завершающуюся значением NULL, которая указывает имя задания печати (например, "MS-WORD: Review.doc").

pNotifyName

Указатель на строку, завершающуюся нулевым значением, которая указывает имя пользователя, который должен получать уведомления при печати задания или при возникновении ошибки во время печати задания.

pDatatype

Указатель на строку, завершающуюся значением NULL, которая указывает тип данных, используемых для записи задания печати.

pPrintProcessor

Указатель на строку, завершающуюся значением NULL, которая указывает имя обработчика печати, который должен использоваться для печати задания.

pParameters

Указатель на строку, завершающуюся нулевым значением, которая указывает параметры процессора печати.

pDriverName

Указатель на строку, завершающуюся значением NULL, которая указывает имя драйвера принтера, который должен использоваться для обработки задания печати.

pDevMode

Указатель на структуру DEVMODE , содержащую данные инициализации устройства и среды для драйвера принтера.

pStatus

Указатель на строку, завершающуюся значением NULL, которая указывает состояние задания печати. Этот элемент должен быть проверен перед параметром Состояние , и, если pStatus имеет значение NULL, состояние определяется содержимым элемента Status.

pSecurityDescriptor

Значение этого элемента равно NULL. Извлечение и настройка дескрипторов безопасности документов в этом выпуске не поддерживаются.

Состояние

Состояние задания. Этот элемент может иметь одно или несколько из следующих значений.

Значение	Значение
JOB_STATUS_BLOCKED_DEVQ	Драйвер не может распечатать задание.
JOB_STATUS_DELETED	Задание удалено.
JOB_STATUS_DELETING	Задание удаляется.
JOB_STATUS_ERROR	С заданием связана ошибка.
JOB_STATUS_OFFLINE	Принтер находится в автономном режиме.
JOB_STATUS_PAPEROUT	Принтер не на бумаге.
JOB_STATUS_PAUSED	Задание приостановлено.
JOB_STATUS_PRINTED	Задание напечатано.
JOB_STATUS_PRINTING	Задание печатается.
JOB_STATUS_RESTART	Задание перезапущено.
JOB_STATUS_SPOOLING	Задание выполняется в очереди.
JOB_STATUS_USER_INTERVENTION	Принтер имеет ошибку, которая требует от пользователя выполнить что-то.

В Windows XP и более поздних версиях Windows также можно использовать следующие значения:

Значение	Значение
JOB_STATUS_COMPLETE	Задание отправляется на принтер, но может быть еще не напечатано. Дополнительные сведения см. в разделе "Примечания".
JOB_STATUS_RETAINED	Задание было сохранено в очереди печати после печати.

Приоритет

Приоритет задания. Этот элемент может быть одним из следующих значений или находиться в диапазоне от 1 до 99 (от MIN_PRIORITY до MAX_PRIORITY).

Значение	Значение
MIN_PRIORITY	Минимальный приоритет.
MAX_PRIORITY	Максимальный приоритет.
DEF_PRIORITY	Приоритет по умолчанию.

Положение

Позиция задания в очереди печати.

StartTime

Самое раннее время печати задания.

UntilTime

Последнее время печати задания.

TotalPages

Количество страниц, необходимых для задания. Это значение может быть равно нулю, если задание печати не содержит сведений о разделителях страниц.

Размер

Размер задания в байтах.

Отправлено

Структура SYSTEMTIME , указывающая время отправки задания.

Это значение времени имеет формат utc. Перед отображением его следует преобразовать в значение местного времени. Для выполнения преобразования можно использовать функцию FileTimeToLocalFileTime .

Время

Общее время в миллисекундах, прошедшее с момента начала печати задания.

PagesPrinted

Количество напечатанных страниц. Это значение может быть равно нулю, если задание печати не содержит сведений о разделителях страниц.

Комментарии

Мониторы портов, которые не поддерживают TrueEndOfJob, будут устанавливать задание как JOB_STATUS_PRINTED сразу после отправки задания на принтер.

Требования

См. также раздел

Вывод на печать

Структуры API очереди печати печати

DEVMODE

Задания перечисления

GetJob

SetJob