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

структура JOB_INFO_1

  • Статья

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

Синтаксис

typedef struct _JOB_INFO_1 {
  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, *PJOB_INFO_1;

Члены

JobId

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

pPrinterName

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

pMachineName

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

pUserName

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

pDocument

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

pDatatype

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

pStatus

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

Состояние

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

Значение Значение
JOB_STATUS_BLOCKED_DEVQ Драйвер не может распечатать задание.
JOB_STATUS_COMPLETE Windows XP и более поздние версии: Задание отправляется на принтер, но задание может быть еще не напечатано.
Дополнительные сведения см. в разделе "Примечания".
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_RETAINED Windows Vista и более поздних версий: Задание сохранено в очереди печати и не может быть удалено. Это может быть вызвано следующими проблемами:
1) Задание было сохранено вручную при вызове SetJob, и диспетчер очереди ожидает освобождения задания.
2) Задание не завершило печать и должно завершить печать, прежде чем его можно будет автоматически удалить.
Дополнительные сведения о командах задания печати см. в разделе SetJob .
JOB_STATUS_SPOOLING Задание выполняется в очереди.
JOB_STATUS_USER_INTERVENTION Принтер имеет ошибку, которая требует от пользователя выполнить что-то.

Приоритет

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

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

Положение

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

TotalPages

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

PagesPrinted

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

Отправлено

Структура SYSTEMTIME , указывающая время, когда был создан этот документ.

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

Комментарии

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

Требования

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

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

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

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

EnumJobs

GetJob

Задание SetJob