estrutura PRINT_OTHER_INFO (lmalert.h)

Artigo
08/24/2023

A estrutura PRINT_OTHER_INFO contém informações sobre um trabalho de impressão. As funções NetAlertRaise e NetAlertRaiseEx usam a estrutura PRINT_OTHER_INFO para especificar informações quando um trabalho terminar de imprimir ou quando uma impressora precisar de intervenção.

Sintaxe

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;

Membros

alrtpr_jobid

Tipo: DWORD

O número de identificação do trabalho de impressão.

alrtpr_status

Tipo: DWORD

Uma máscara de bits que descreve o status do trabalho de impressão.

Você pode obter a status geral do trabalho verificando PRJOB_QSTATUS (bits 0 e 1).

Os valores possíveis para o trabalho de impressão status estão listados no arquivo de cabeçalho Lmalert.h.

Valor	Significado
PRJOB_QS_QUEUED 0	O trabalho de impressão está na fila aguardando para ser agendado.
PRJOB_QS_PAUSED 1	O trabalho de impressão está na fila, mas foi pausado. (Quando um trabalho está em pausa, ele não pode ser agendado.)
PRJOB_QS_SPOOLING 2	O trabalho de impressão está em processo de spool.
PRJOB_QS_PRINTING 3	O trabalho está sendo impresso no momento.

Se o trabalho de impressão estiver no estado PRJOB_QS_PRINTING, você poderá marcar bits de 2 a 8 para o status do dispositivo (PRJOB_DEVSTATUS). O bit 15 também é significativo.

Os valores possíveis para o status do dispositivo são listados no arquivo de cabeçalho Lmalert.h.

Valor	Significado
PRJOB_COMPLETE 0x4	O trabalho concluiu a impressão.
PRJOB_INTERV 0x8	A impressora de destino requer a intervenção de um operador.
PRJOB_ERROR 0x10	Há um erro na impressora de destino.
PRJOB_DESTOFFLINE 0x20	A impressora de destino está offline.
PRJOB_DESTPAUSED 0x40	A impressora de destino está em pausa.
PRJOB_NOTIFY 0x80	Um alerta de impressão deve ser gerado.
PRJOB_DESTNOPAPER 0x100	A impressora de destino está sem papel.
PRJOB_DELETED 0x8000	O trabalho de impressão está sendo excluído.

alrtpr_submitted

Tipo: DWORD

A hora em que o trabalho de impressão foi enviado. Esse valor é armazenado como o número de segundos decorridos desde 00:00:00, 1º de janeiro de 1970, GMT.

alrtpr_size

Tipo: DWORD

O tamanho, em bytes, do trabalho de impressão.

Comentários

Dados adicionais de comprimento variável seguem a estrutura PRINT_OTHER_INFO no buffer de mensagens de alerta. As informações estão na forma de cadeias de caracteres terminadas em nulo contíguas, da seguinte maneira.

String	Significado
computername	O computador que enviou o trabalho de impressão.
Nome de Usuário	O usuário que enviou o trabalho de impressão.
Queuename	A fila de impressão para a qual o trabalho foi enviado.
destino	O destino da impressora (dispositivo) para o qual o trabalho de impressão foi roteado.
status	O status do trabalho de impressão.

O aplicativo de chamada deve alocar e liberar a memória para todas as estruturas e dados de comprimento variável em um buffer de mensagens de alerta.

Consulte NetAlertRaiseEx para obter um exemplo de código que demonstra como gerar um alerta de impressão.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho	lmalert.h (inclua Lm.h)