Share via

структура PORT_INFO_3

  • Статья

Структура PORT_INFO_3 указывает значение состояния порта принтера.

Синтаксис

typedef struct _PORT_INFO_3 {
  DWORD  dwStatus;
  LPTSTR pszStatus;
  DWORD  dwSeverity;
} PORT_INFO_3, *PPORT_INFO_3;

Члены

dwStatus

Новое значение состояния порта. Это значение используется только в том случае, если член pszStatus имеет значение NULL.

Этот элемент может быть одним из следующих значений.

Значение Значение
0 Очищает состояние порта принтера.
PORT_STATUS_OFFLINE Принтер порта находится в автономном режиме.
PORT_STATUS_PAPER_JAM На принтере порта есть затметь бумагу.
PORT_STATUS_PAPER_OUT Принтер порта не имеет бумаги.
PORT_STATUS_OUTPUT_BIN_FULL Выходной контейнер принтера порта заполнен.
PORT_STATUS_PAPER_PROBLEM На принтере порта возникла проблема с бумагой.
PORT_STATUS_NO_TONER Принтер порта не работает.
PORT_STATUS_DOOR_OPEN Дверь принтера порта открыта.
PORT_STATUS_USER_INTERVENTION Принтер порта требует вмешательства пользователя.
PORT_STATUS_OUT_OF_MEMORY На принтере порта не хватает памяти.
PORT_STATUS_TONER_LOW Принтер порта имеет низкий уровень тонера.
PORT_STATUS_WARMING_UP Принтер порта прогревается.
PORT_STATUS_POWER_SAVE Принтер порта находится в режиме экономии энергии.

pszStatus

Указатель на новую строку состояния порта принтера, которая требуется задать. Используйте этот элемент, если нет подходящего значения состояния среди перечисленных для dwStatus.

dwSeverity

Серьезность значения состояния порта.

Этот элемент может быть одним из следующих значений.

Значение Значение
PORT_STATUS_TYPE_ERROR Значение состояния порта указывает на ошибку.
PORT_STATUS_TYPE_WARNING Значение состояния порта — предупреждение.
PORT_STATUS_TYPE_INFO Значение состояния порта — информационное.

Комментарии

При установке значения состояния порта принтера со значением серьезности PORT_STATUS_TYPE_ERROR очередь печати печати прекращает отправку заданий на этот порт. Очередь печати печати не возобновляет отправку заданий на порт, пока не будет выполнен другой вызов SetPort для очистки состояния.

Требования

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

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

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

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

SetPort