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 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 valores siguientes.
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 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.
-
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.
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 |
|
| Nombres Unicode y ANSI |
_JOB_INFO_2W (Unicode) y _JOB_INFO_2A (ANSI) |