estructura de PRINTER_NOTIFY_INFO_DATA

La estructura PRINTER_NOTIFY_INFO_DATA identifica un campo de información de trabajo o impresora y proporciona los datos actuales de ese campo.

La función FindNextPrinterChangeNotification devuelve una estructura PRINTER_NOTIFY_INFO , que contiene una matriz de estructuras PRINTER_NOTIFY_INFO_DATA .

Sintaxis

typedef struct _PRINTER_NOTIFY_INFO_DATA {
  WORD  Type;
  WORD  Field;
  DWORD Reserved;
  DWORD Id;
  union {
    DWORD  adwData[2];
    struct {
      DWORD  cbBuf;
      LPVOID pBuf;
    } Data;
  } NotifyData;
} PRINTER_NOTIFY_INFO_DATA, *PPRINTER_NOTIFY_INFO_DATA; ;

Miembros

Tipo

Indica el tipo de información proporcionada. Este miembro puede ser uno de los valores siguientes.

Valor	Significado
JOB_NOTIFY_TYPE 0x01	Indica que el miembro Field especifica una constante JOB_NOTIFY_FIELD_*.
PRINTER_NOTIFY_TYPE 0x00	Indica que el miembro Field especifica una constante PRINTER_NOTIFY_FIELD_*.

Campo

Indica el campo que cambió. Para obtener una lista de los valores posibles, vea la sección Comentarios.

Reserved

Reservado.

Id

Indica el identificador de trabajo si el miembro Type especifica JOB_NOTIFY_TYPE. Si el miembro Type especifica PRINTER_NOTIFY_TYPE, este miembro no está definido.

NotifyData

Unión de información de datos basada en los miembros Type y Field . Para obtener una descripción del tipo de datos asociado a cada campo, vea la sección Comentarios.

adwData[2]

Matriz de dos valores DWORD . Para los campos de información que usan solo una DWORD, los datos están en adwData [0].

Datos

cbBuf

Indica el tamaño, en bytes, del búfer al que apunta pBuf.

pBuf

Puntero a un búfer que contiene los datos actuales del campo.

Comentarios

Si el miembro Type especifica PRINTER_NOTIFY_TYPE, el miembro Field puede ser uno de los valores siguientes.

Campo	Tipo de datos	Valor
PRINTER_NOTIFY_FIELD_SERVER_NAME	No compatible.	0x00
PRINTER_NOTIFY_FIELD_PRINTER_NAME	pBuf es un puntero a una cadena terminada en null que contiene el nombre de la impresora.	0x01
PRINTER_NOTIFY_FIELD_SHARE_NAME	pBuf es un puntero a una cadena terminada en null que identifica el punto de recurso compartido de la impresora.	0x02
PRINTER_NOTIFY_FIELD_PORT_NAME	pBuf es un puntero a una cadena terminada en null que contiene el nombre del puerto en el que se imprimirán los trabajos de impresión. Si se selecciona "Agrupación de impresoras", se trata de una lista separada por comas de puertos.	0x03
PRINTER_NOTIFY_FIELD_DRIVER_NAME	pBuf es un puntero a una cadena terminada en null que contiene el nombre del controlador de la impresora.	0x04
PRINTER_NOTIFY_FIELD_COMMENT	pBuf es un puntero a una cadena terminada en null que contiene la nueva cadena de comentario, que suele ser una breve descripción de la impresora.	0x05
PRINTER_NOTIFY_FIELD_LOCATION	pBuf es un puntero a una cadena terminada en null que contiene la nueva ubicación física de la impresora (por ejemplo, "Bldg. 38, Room 1164").	0x06
PRINTER_NOTIFY_FIELD_DEVMODE	pBuf es un puntero a una estructura DEVMODE que define los datos predeterminados de la impresora, como la orientación del papel y la resolución.	0x07
PRINTER_NOTIFY_FIELD_SEPFILE	pBuf es un puntero a una cadena terminada en NULL que especifica el nombre del archivo utilizado para crear la página de separador. Esta página se usa para separar los trabajos de impresión enviados a la impresora.	0x08
PRINTER_NOTIFY_FIELD_PRINT_PROCESSOR	pBuf es un puntero a una cadena terminada en null que especifica el nombre del procesador de impresión utilizado por la impresora.	0x09
PRINTER_NOTIFY_FIELD_PARAMETERS	pBuf es un puntero a una cadena terminada en null que especifica los parámetros predeterminados del procesador de impresión.	0x0A
PRINTER_NOTIFY_FIELD_DATATYPE	pBuf es un puntero a una cadena terminada en null que especifica el tipo de datos utilizado para registrar el trabajo de impresión.	0x0B
PRINTER_NOTIFY_FIELD_SECURITY_DESCRIPTOR	pBuf es un puntero a una estructura SECURITY_DESCRIPTOR para la impresora. El puntero puede ser NULL si no hay ningún descriptor de seguridad.	0x0C
PRINTER_NOTIFY_FIELD_ATTRIBUTES	adwData [0] especifica los atributos de impresora, que pueden ser uno de los siguientes valores: PRINTER_ATTRIBUTE_QUEUED PRINTER_ATTRIBUTE_DIRECT PRINTER_ATTRIBUTE_DEFAULT PRINTER_ATTRIBUTE_SHARED	0x0D
PRINTER_NOTIFY_FIELD_PRIORITY	adwData [0] especifica un valor de prioridad que el administrador de trabajos de cola usa para enrutar los trabajos de impresión.	0x0E
PRINTER_NOTIFY_FIELD_DEFAULT_PRIORITY	adwData [0] especifica el valor de prioridad predeterminado asignado a cada trabajo de impresión.	0x0F
PRINTER_NOTIFY_FIELD_START_TIME	adwData [0] especifica la hora más temprana en la que la impresora imprimirá un trabajo. (Este valor se especifica en minutos transcurridos desde las 12:00 a.m.)	0x10
PRINTER_NOTIFY_FIELD_UNTIL_TIME	adwData [0] especifica la hora más reciente en la que la impresora imprimirá un trabajo. (Este valor se especifica en minutos transcurridos desde las 12:00 A.M.)	0x11
PRINTER_NOTIFY_FIELD_STATUS	adwData [0] especifica el estado de la impresora. Para obtener una lista de los valores posibles, consulte la estructura PRINTER_INFO_2 .	0x12
PRINTER_NOTIFY_FIELD_STATUS_STRING	No compatible.	0x13
PRINTER_NOTIFY_FIELD_CJOBS	adwData [0] especifica el número de trabajos de impresión que se han puesto en cola para la impresora.	0x14
PRINTER_NOTIFY_FIELD_AVERAGE_PPM	adwData [0] especifica el número medio de páginas por minuto que se han impreso en la impresora.	0x15
PRINTER_NOTIFY_FIELD_TOTAL_PAGES	No compatible.	0x16
PRINTER_NOTIFY_FIELD_PAGES_PRINTED	No compatible.	0 x 17
PRINTER_NOTIFY_FIELD_TOTAL_BYTES	No compatible.	0x18
PRINTER_NOTIFY_FIELD_BYTES_PRINTED	No compatible.	0x19
PRINTER_NOTIFY_FIELD_OBJECT_GUID	Esto se establece si cambia el GUID del objeto.	0x1A
PRINTER_NOTIFY_FIELD_FRIENDLY_NAME	Se establece si se cambia el nombre de la conexión de la impresora.	0x1B

Si el miembro Type especifica JOB_NOTIFY_TYPE, el miembro Field puede ser uno de los siguientes valores.

Campo	Tipo de datos	Valor
JOB_NOTIFY_FIELD_PRINTER_NAME	pBuf es un puntero a una cadena terminada en null que contiene el nombre de la impresora para la que se agrupa el trabajo.	0x00
JOB_NOTIFY_FIELD_MACHINE_NAME	pBuf es un puntero a una cadena terminada en null que especifica el nombre de la máquina que creó el trabajo de impresión.	0x01
JOB_NOTIFY_FIELD_PORT_NAME	pBuf es un puntero a una cadena terminada en null que identifica los puertos usados para transmitir datos a la impresora. Si una impresora está conectada a más de un puerto, los nombres de los puertos se separan por comas (por ejemplo, "LPT1:,LPT2:,LPT3:").	0x02
JOB_NOTIFY_FIELD_USER_NAME	pBuf es un puntero a una cadena terminada en null que especifica el nombre del usuario que envió el trabajo de impresión.	0x03
JOB_NOTIFY_FIELD_NOTIFY_NAME	pBuf es un 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.	0x04
JOB_NOTIFY_FIELD_DATATYPE	pBuf es un puntero a una cadena terminada en null que especifica el tipo de datos que se usan para registrar el trabajo de impresión.	0x05
JOB_NOTIFY_FIELD_PRINT_PROCESSOR	pBuf es un puntero a una cadena terminada en null que especifica el nombre del procesador de impresión que se va a usar para imprimir el trabajo.	0x06
JOB_NOTIFY_FIELD_PARAMETERS	pBuf es un puntero a una cadena terminada en null que especifica parámetros de procesador de impresión.	0x07
JOB_NOTIFY_FIELD_DRIVER_NAME	pBuf es un 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.	0x08
JOB_NOTIFY_FIELD_DEVMODE	pBuf es un puntero a una estructura DEVMODE que contiene datos de entorno y inicialización del dispositivo para el controlador de impresora.	0x09
JOB_NOTIFY_FIELD_STATUS	adwData [0] especifica el estado del trabajo. Para obtener una lista de los valores posibles, consulte la estructura JOB_INFO_2 .	0x0A
JOB_NOTIFY_FIELD_STATUS_STRING	pBuf es un puntero a una cadena terminada en null que especifica el estado del trabajo de impresión.	0x0B
JOB_NOTIFY_FIELD_SECURITY_DESCRIPTOR	No compatible.	0x0C
JOB_NOTIFY_FIELD_DOCUMENT	pBuf es un puntero a una cadena terminada en null que especifica el nombre del trabajo de impresión (por ejemplo, "MS-WORD: Review.doc").	0x0D
JOB_NOTIFY_FIELD_PRIORITY	adwData [0] especifica la prioridad del trabajo.	0x0E
JOB_NOTIFY_FIELD_POSITION	adwData [0] especifica la posición del trabajo en la cola de impresión.	0x0F
JOB_NOTIFY_FIELD_SUBMITTED	pBuf es un puntero a una estructura SYSTEMTIME que especifica la hora en que se envió el trabajo.	0x10
JOB_NOTIFY_FIELD_START_TIME	adwData [0] especifica la primera vez que se puede imprimir el trabajo. (Este valor se especifica en minutos transcurridos desde las 12:00 A.M.)	0x11
JOB_NOTIFY_FIELD_UNTIL_TIME	adwData [0] especifica la hora más reciente en que se puede imprimir el trabajo. (Este valor se especifica en minutos transcurridos desde las 12:00 A.M.)	0x12
JOB_NOTIFY_FIELD_TIME	adwData [0] especifica el tiempo total, en segundos, que ha transcurrido desde que el trabajo comenzó a imprimirse.	0x13
JOB_NOTIFY_FIELD_TOTAL_PAGES	adwData [0] especifica el tamaño, en páginas, del trabajo.	0x14
JOB_NOTIFY_FIELD_PAGES_PRINTED	adwData [0] especifica el número de páginas que se han impreso.	0x15
JOB_NOTIFY_FIELD_TOTAL_BYTES	adwData [0] especifica el tamaño, en bytes, del trabajo.	0x16
JOB_NOTIFY_FIELD_BYTES_PRINTED	adwData [0] especifica el número de bytes que se han impreso en este trabajo. Para este campo, el objeto de notificación de cambios se señala cuando se envían bytes a la impresora.	0 x 17

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)

Consulte también

Impresión

Imprimir estructuras de API de administrador de trabajos

DEVMODE

FindNextPrinterChangeNotification

JOB_INFO_2

PRINTER_INFO_2

PRINTER_NOTIFY_INFO

SECURITY_DESCRIPTOR

SYSTEMTIME