estructura de JOB_INFO_4

Describe un conjunto completo de valores asociados a un trabajo y admite archivos de cola grandes con tamaños expresados con 64 bits.

Sintaxis

typedef struct _JOB_INFO_4 {
  DWORD                JobId;
  LPTSTR               pPrinterName;
  LPTSTR               pMachineName;
  LPTSTR               pUserName;
  LPTSTR               pDocument;
  LPTSTR               pNotifyName;
  LPTSTR               pDatatype;
  LPTSTR               pPrintProcessor;
  LPTSTR               pParameters;
  LPTSTR               pDriverName;
  LPDEVMODE            pDevMode;
  LPTSTR               pStatus;
  PSECURITY_DESCRIPTOR pSecurityDescriptor;
  DWORD                Status;
  DWORD                Priority;
  DWORD                Position;
  DWORD                StartTime;
  DWORD                UntilTime;
  DWORD                TotalPages;
  DWORD                Size;
  SYSTEMTIME           Submitted;
  DWORD                Time;
  DWORD                PagesPrinted;
  LONG                 SizeHigh;
} JOB_INFO_4, *PJOB_INFO_4;

Miembros

JobId

Valor de 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").

pNotifyName

Puntero a una cadena terminada en null que especifica el nombre del usuario que debe recibir una notificación cuando se haya impreso el trabajo o cuando se produzca un error al imprimir el trabajo.

pDatatype

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

pPrintProcessor

Puntero a una cadena terminada en null que especifica el nombre del procesador de impresión que se debe usar para imprimir el trabajo.

pParameters

Puntero a una cadena terminada en null que especifica parámetros de procesador de impresión.

pDriverName

Puntero a una cadena terminada en null que especifica el nombre del controlador de impresora que se debe usar para procesar el trabajo de impresión.

pDevMode

Puntero a una estructura DEVMODE que contiene datos de entorno y inicialización del dispositivo para el controlador de impresora.

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.

pSecurityDescriptor

El valor de este miembro es NULL. La recuperación y configuración de descriptores de seguridad de documentos no se admite en esta versión.

Estado

Estado del trabajo. Este miembro puede ser uno o varios de los siguientes valores:

Valor	Significado
JOB_STATUS_BLOCKED_DEVQ	El controlador no puede imprimir el trabajo.
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_SPOOLING	El trabajo está en cola.
JOB_STATUS_USER_INTERVENTION	La impresora tiene un error que requiere que el usuario haga algo.

En Windows XP y versiones posteriores de Windows, también se pueden usar los siguientes valores:

Valor	Significado
JOB_STATUS_COMPLETE	El trabajo se envía a la impresora, pero es posible que aún no se imprima. Vea Comentarios para obtener más información.
JOB_STATUS_RETAINED	El trabajo se ha conservado en la cola de impresión después de la impresión.

Prioridad

Prioridad del trabajo. Este miembro puede ser uno de los valores siguientes 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.

StartTime

La primera vez que se puede imprimir el trabajo.

UntilTime

La hora más reciente en que se puede imprimir el trabajo.

TotalPages

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

Tamaño

Los cuatro bytes inferiores del tamaño, en bytes, del trabajo. Consulte también el miembro SizeHigh a continuación.

Enviado

Estructura SYSTEMTIME que especifica la hora en que se envió el trabajo.

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.

Time

Tiempo total, en milisegundos, que ha transcurrido desde que el trabajo comenzó a imprimirse.

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.

SizeHigh

Los cuatro bytes mayores del tamaño, en bytes, del trabajo. Consulte también el miembro Size anterior.

Comentarios

Los monitores de puerto que no admiten TrueEndOfJob establecerán el trabajo como JOB_STATUS_PRINTED inmediatamente 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
Nombres Unicode y ANSI	_JOB_INFO_4W (Unicode) y _JOB_INFO_4A (ANSI)

Consulte también

Impresión

Imprimir estructuras de API de administrador de trabajos

DEVMODE

EnumJobs

GetJob

SetJob