estructura PRINT_OTHER_INFO (lmalert.h)

Artículo
08/24/2023

La estructura PRINT_OTHER_INFO contiene información sobre un trabajo de impresión. Las funciones NetAlertRaise y NetAlertRaiseEx usan la estructura de PRINT_OTHER_INFO para especificar información cuando un trabajo ha terminado de imprimirse o cuando una impresora necesita intervención.

Sintaxis

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;

Miembros

alrtpr_jobid

Tipo: DWORD

Número de identificación del trabajo de impresión.

alrtpr_status

Tipo: DWORD

Máscara de bits que describe el estado del trabajo de impresión.

Puede obtener el estado general del trabajo comprobando PRJOB_QSTATUS (bits 0 y 1).

Los valores posibles para el estado del trabajo de impresión se muestran en el archivo de encabezado Lmalert.h .

Valor	Significado
PRJOB_QS_QUEUED 0	El trabajo de impresión está en la cola esperando que se programe.
PRJOB_QS_PAUSED 1	El trabajo de impresión está en la cola, pero se ha pausado. (Cuando un trabajo está en pausa, no se puede programar).
PRJOB_QS_SPOOLING 2	El trabajo de impresión está en proceso de cola.
PRJOB_QS_PRINTING 3	El trabajo está imprimiendo actualmente.

Si el trabajo de impresión está en estado PRJOB_QS_PRINTING, puede comprobar los bits del 2 al 8 para el estado del dispositivo (PRJOB_DEVSTATUS). El bit 15 también es significativo.

Los valores posibles para el estado del dispositivo se muestran en el archivo de encabezado Lmalert.h .

Valor	Significado
PRJOB_COMPLETE 0x4	El trabajo ha completado la impresión.
PRJOB_INTERV 0x8	La impresora de destino requiere la intervención de un operador.
PRJOB_ERROR 0x10	Hay un error en la impresora de destino.
PRJOB_DESTOFFLINE 0x20	La impresora de destino está sin conexión.
PRJOB_DESTPAUSED 0x40	La impresora de destino está en pausa.
PRJOB_NOTIFY 0x80	Se debe generar una alerta de impresión.
PRJOB_DESTNOPAPER 0x100	La impresora de destino está fuera de papel.
PRJOB_DELETED 0x8000	Se está eliminando el trabajo de impresión.

alrtpr_submitted

Tipo: DWORD

Hora en la que se envió el trabajo de impresión. Este valor se almacena como el número de segundos transcurridos desde las 00:00:00, 1 de enero de 1970, GMT.

alrtpr_size

Tipo: DWORD

Tamaño, en bytes, del trabajo de impresión.

Comentarios

Los datos de longitud variable adicionales siguen la estructura de PRINT_OTHER_INFO en el búfer de mensajes de alerta. La información tiene el formato de cadenas de caracteres contiguas terminadas en null, como se indica a continuación.

String	Significado
computername	Equipo que envió el trabajo de impresión.
username	Usuario que envió el trabajo de impresión.
queuename	Cola de impresión a la que se envió el trabajo.
destination	Destino de la impresora (dispositivo) al que se enruta el trabajo de impresión.
status	Estado del trabajo de impresión.

La aplicación que llama debe asignar y liberar la memoria para todas las estructuras y los datos de longitud variable en un búfer de mensajes de alerta.

Consulte NetAlertRaiseEx para ver un ejemplo de código que muestra cómo generar una alerta de impresión.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado	lmalert.h (include Lm.h)