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


структура JOB_INFO_4

Описывает полный набор значений, связанных с заданием, и поддерживает большие файлы очереди с размерами, выраженными 64 битами.

Синтаксис

typedef struct _JOB_INFO_4 {
  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;
  LONG                 SizeHigh;
} JOB_INFO_4, *PJOB_INFO_4;

Члены

JobId

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

pPrinterName

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

pMachineName

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

pUserName

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

pDocument

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

pNotifyName

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

pDatatype

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

pPrintProcessor

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

pParameters

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

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

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

Размер

Нижние четыре байта размера (в байтах) задания. См. также элемент SizeHigh ниже.

Отправлено

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

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

Время

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

PagesPrinted

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

SizeHigh

Более высокие четыре байта размера (в байтах) задания. См. также элемент Size выше.

Комментарии

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

Требования

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

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

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

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

DEVMODE

EnumJobs

GetJob

Задание SetJob