структура JOB_INFO_1

Статья
06/12/2023

Структура 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 .

Требования

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

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

Вывод на печать
Структуры API очереди печати печати
EnumJobs
GetJob
Задание SetJob

Share via

структура JOB_INFO_1

Синтаксис

Члены

Комментарии

Требования

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

Обратная связь

Обратная связь

Дополнительные ресурсы