estructura de JOB_INFO_1

La estructura JOB_INFO_1 especifica información del trabajo de impresión, como el valor del identificador de trabajo, el nombre de la impresora para la que se agrupa el trabajo, el nombre del equipo que creó el trabajo de impresión, el nombre del usuario que posee el trabajo de impresión, etc.

Sintaxis

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;

Miembros

JobId

Identificador de trabajo.

pPrinterName

Puntero a una cadena terminada en null que especifica el nombre de la impresora para la que se agrupa el trabajo.

pMachineName

Puntero a una cadena terminada en null que especifica el nombre de la máquina que creó el trabajo de impresión.

pUserName

Puntero a una cadena terminada en null que especifica el nombre del usuario que posee el trabajo de impresión.

pDocument

Puntero a una cadena terminada en null que especifica el nombre del trabajo de impresión (por ejemplo, "MS-WORD: Review.doc").

pDatatype

Puntero a una cadena terminada en null que especifica el tipo de datos usado para registrar el trabajo de impresión.

pStatus

Puntero a una cadena terminada en null que especifica el estado del trabajo de impresión. Este miembro debe comprobarse antes de Status y, si pStatus es NULL, el estado se define mediante el contenido del miembro Status.

Estado

Estado del trabajo. El valor de este miembro puede ser cero o una combinación de uno o varios de los valores siguientes. Un valor de cero indica que la cola de impresión se ha pausado después de que el documento haya terminado de poner en cola.

Valor	Significado
JOB_STATUS_BLOCKED_DEVQ	El controlador no puede imprimir el trabajo.
JOB_STATUS_COMPLETE	Windows XP y versiones posteriores: El trabajo se envía a la impresora, pero es posible que aún no se imprima el trabajo. Vea Comentarios para obtener más información.
JOB_STATUS_DELETED	Se ha eliminado el trabajo.
JOB_STATUS_DELETING	Se está eliminando el trabajo.
JOB_STATUS_ERROR	Se asocia un error al trabajo.
JOB_STATUS_OFFLINE	La impresora está sin conexión.
JOB_STATUS_PAPEROUT	La impresora está fuera de papel.
JOB_STATUS_PAUSED	El trabajo está en pausa.
JOB_STATUS_PRINTED	El trabajo se ha impreso.
JOB_STATUS_PRINTING	El trabajo está imprimiendo.
JOB_STATUS_RESTART	Se ha reiniciado el trabajo.
JOB_STATUS_RETAINED	Windows Vista y versiones posteriores: El trabajo se ha conservado en la cola de impresión y no se puede eliminar. Esto puede deberse a lo siguiente: 1) El trabajo se retenía manualmente mediante una llamada a SetJob y el colador está esperando a que se libere el trabajo. 2) El trabajo no ha terminado de imprimir y debe finalizar la impresión antes de que se pueda eliminar automáticamente. Consulte SetJob para obtener más información sobre los comandos de trabajo de impresión.
JOB_STATUS_SPOOLING	El trabajo está en cola.
JOB_STATUS_USER_INTERVENTION	La impresora tiene un error que requiere que el usuario haga algo.

Prioridad

Prioridad del trabajo. Este miembro puede ser uno de los siguientes valores o entre 1 y 99 (MIN_PRIORITY a MAX_PRIORITY).

Valor	Significado
MIN_PRIORITY	Prioridad mínima.
MAX_PRIORITY	Prioridad máxima.
DEF_PRIORITY	Prioridad predeterminada.

Posición

Posición del trabajo en la cola de impresión.

TotalPages

Número total de páginas que contiene el documento. Este valor puede ser cero si el trabajo de impresión no contiene información delimitadora de páginas.

PagesPrinted

Número de páginas que se han impreso. Este valor puede ser cero si el trabajo de impresión no contiene información delimitadora de páginas.

Enviado

Estructura SYSTEMTIME que especifica la hora en que se ha colado este documento.

Este valor de hora está en formato de coordenadas horarias universales (UTC). Debe convertirlo en un valor de hora local antes de mostrarlo. Puede usar la función FileTimeToLocalFileTime para realizar la conversión.

Comentarios

Los monitores de puerto que no admiten TrueEndOfJob establecerán el trabajo como JOB_STATUS_PRINTED justo después de enviar el trabajo a la impresora.

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	Winspool.h (incluye Windows.h)
Nombres Unicode y ANSI	_JOB_INFO_1W (Unicode) y _JOB_INFO_1A (ANSI)

Consulte también

Impresión

Imprimir estructuras de API de Spooler

EnumJobs

GetJob

SetJob