Поделиться через

структура 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 сразу после отправки задания на принтер.

Требования

Требование Значение
Минимальная версия клиента
 Windows 2000 Professional [только классические приложения]
Минимальная версия сервера
 Windows 2000 Server [только классические приложения]
Заголовок
Winspool.h (включая Windows.h)
Имя в кодировке Юникод и ANSI
 _JOB_INFO_2W (Юникод) и _JOB_INFO_2A (ANSI)

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

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

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

DEVMODE

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

GetJob

SetJob