структура PRINT_OTHER_INFO (lmalert.h)

Статья
02/28/2024

Структура PRINT_OTHER_INFO содержит сведения о задании печати. Функции NetAlertRaise и NetAlertRaiseEx используют структуру PRINT_OTHER_INFO для указания сведений о завершении печати задания или необходимости вмешательства принтера.

Синтаксис

typedef struct _PRINT_OTHER_INFO {
  DWORD alrtpr_jobid;
  DWORD alrtpr_status;
  DWORD alrtpr_submitted;
  DWORD alrtpr_size;
} PRINT_OTHER_INFO, *PPRINT_OTHER_INFO, *LPPRINT_OTHER_INFO;

Члены

alrtpr_jobid

Тип: DWORD

Идентификационный номер задания печати.

alrtpr_status

Тип: DWORD

Битовая маска, описывающая состояние задания печати.

Общее состояние задания можно получить, проверив PRJOB_QSTATUS (биты 0 и 1).

Возможные значения состояния задания печати перечислены в файле заголовка Lmalert.h .

Значение	Значение
PRJOB_QS_QUEUED 0	Задание печати находится в очереди, ожидая планирования.
PRJOB_QS_PAUSED 1	Задание печати находится в очереди, но приостановлено. (Если задание приостановлено, его невозможно запланировать.)
PRJOB_QS_SPOOLING 2	Задание печати находится в процессе печати.
PRJOB_QS_PRINTING 3	В настоящее время выполняется печать задания.

Если задание печати находится в состоянии PRJOB_QS_PRINTING, можно проверка биты от 2 до 8 для состояния устройства (PRJOB_DEVSTATUS). Бит 15 также имеет смысл.

Возможные значения состояния устройства перечислены в файле заголовка Lmalert.h .

Значение	Значение
PRJOB_COMPLETE 0x4	Задание завершило печать.
PRJOB_INTERV 0x8	Принтер назначения требует вмешательства оператора.
PRJOB_ERROR 0x10	На целевом принтере произошла ошибка.
PRJOB_DESTOFFLINE 0x20	Конечный принтер находится в автономном режиме.
PRJOB_DESTPAUSED 0x40	Конечный принтер приостановлен.
PRJOB_NOTIFY 0x80	Должно быть поднято оповещение о печати.
PRJOB_DESTNOPAPER 0x100	Конечный принтер не имеет бумаги.
PRJOB_DELETED 0x8000	Задание печати удаляется.

alrtpr_submitted

Тип: DWORD

Время отправки задания печати. Это значение хранится в виде количества секунд, прошедших с 00:00:00, 1 января 1970 г., GMT.

alrtpr_size

Тип: DWORD

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

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

Строка	Значение
computername	Компьютер, отправив задание печати.
username	Пользователь, отправивший задание печати.
queuename	Очередь печати, в которую было отправлено задание.
ресурс destination	Назначение принтера (устройство), в которое было перенаправлено задание печати.
status	Состояние задания печати.

Вызывающее приложение должно выделить и освободить память для всех структур и данных переменной длины в буфере сообщений оповещений.

Пример кода, демонстрирующий создание оповещения о печати, см. в статье NetAlertRaiseEx .

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Верхняя часть	lmalert.h (включая Lm.h)