estructura de JOB_INFO_2

La estructura JOB_INFO_2 describe un conjunto completo de valores asociados a un trabajo.

Sintaxis

typedef struct _JOB_INFO_2 {
  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;
} JOB_INFO_2, *PJOB_INFO_2;

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 ha impreso el trabajo o cuando se produce un error al imprimir el trabajo.

pDatatype

Puntero a una cadena terminada en null que especifica el tipo de datos que se usan 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 valores siguientes.

Value 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:

Value 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 siguientes valores o entre 1 y 99 (MIN_PRIORITY a MAX_PRIORITY).

Value 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

Tamaño, en bytes, del trabajo.

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

El tiempo total, en milisegundos, que ha transcurrido desde que el trabajo comenzó a imprimir.

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.

Observaciones

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 (incluya Windows.h)
Nombres Unicode y ANSI
_JOB_INFO_2W (Unicode) y _JOB_INFO_2A (ANSI)

Consulte también

Impresión

Imprimir estructuras de API de Spooler

DEVMODE

EnumJobs

GetJob

SetJob