estructura de PRINTER_INFO_2

Artículo
06/12/2023

La estructura PRINTER_INFO_2 especifica información detallada de la impresora.

Sintaxis

typedef struct _PRINTER_INFO_2 {
  LPTSTR               pServerName;
  LPTSTR               pPrinterName;
  LPTSTR               pShareName;
  LPTSTR               pPortName;
  LPTSTR               pDriverName;
  LPTSTR               pComment;
  LPTSTR               pLocation;
  LPDEVMODE            pDevMode;
  LPTSTR               pSepFile;
  LPTSTR               pPrintProcessor;
  LPTSTR               pDatatype;
  LPTSTR               pParameters;
  PSECURITY_DESCRIPTOR pSecurityDescriptor;
  DWORD                Attributes;
  DWORD                Priority;
  DWORD                DefaultPriority;
  DWORD                StartTime;
  DWORD                UntilTime;
  DWORD                Status;
  DWORD                cJobs;
  DWORD                AveragePPM;
} PRINTER_INFO_2, *PPRINTER_INFO_2;

Miembros

pServerName

Puntero a una cadena terminada en null que identifica el servidor que controla la impresora. Si esta cadena es NULL, la impresora se controla localmente.

pPrinterName

Puntero a una cadena terminada en null que especifica el nombre de la impresora.

pShareName

Puntero a una cadena terminada en null que identifica el punto de recurso compartido de la impresora. (Esta cadena solo se usa si la constante PRINTER_ATTRIBUTE_SHARED se estableció para el miembro Attributes ).

pPortName

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 cada puerto deben estar separados por comas (por ejemplo, "LPT1:,LPT2:,LPT3:").

pDriverName

Puntero a una cadena terminada en null que especifica el nombre del controlador de impresora.

pComment

Puntero a una cadena terminada en null que proporciona una breve descripción de la impresora.

pLocation

Puntero a una cadena terminada en null que especifica la ubicación física de la impresora (por ejemplo, "Bldg. 38, Room 1164").

pDevMode

Puntero a una estructura DEVMODE que define los datos predeterminados de la impresora, como la orientación del papel y la resolución.

pSepFile

Puntero a una cadena terminada en null que especifica el nombre del archivo utilizado para crear la página del separador. Esta página se usa para separar los trabajos de impresión enviados a la impresora.

pPrintProcessor

Puntero a una cadena terminada en null que especifica el nombre del procesador de impresión utilizado por la impresora. Puede usar la función EnumPrintProcessors para obtener una lista de procesadores de impresión instalados en un servidor.

pDatatype

Puntero a una cadena terminada en null que especifica el tipo de datos utilizado para registrar el trabajo de impresión. Puede usar la función EnumPrintProcessorDatatypes para obtener una lista de tipos de datos admitidos por un procesador de impresión específico.

pParameters

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

pSecurityDescriptor

Puntero a una estructura de SECURITY_DESCRIPTOR para la impresora. Este miembro puede ser NULL.

Atributos

Atributos de impresora. Este miembro puede ser cualquier combinación razonable de los valores siguientes.

Valor	Significado
PRINTER_ATTRIBUTE_DIRECT	El trabajo se envía directamente a la impresora (no está en cola).
PRINTER_ATTRIBUTE_DO_COMPLETE_FIRST	Si se establece y se establece la impresora para la impresión en cola, los trabajos que hayan completado la cola se programan para imprimir antes de que los trabajos que no hayan completado la cola.
PRINTER_ATTRIBUTE_ENABLE_DEVQ	Si se establece, se llama a DevQueryPrint . DevQueryPrint puede producir un error si las configuraciones de documento e impresora no coinciden. Si se establece esta marca, los documentos no coinciden se mantienen en la cola.
PRINTER_ATTRIBUTE_HIDDEN	Reservado.
PRINTER_ATTRIBUTE_KEEPPRINTEDJOBS	Si se establece, los trabajos se conservan después de imprimirlos. Si no se establece, se eliminan los trabajos.
PRINTER_ATTRIBUTE_LOCAL	La impresora es una impresora local.
PRINTER_ATTRIBUTE_NETWORK	La impresora es una conexión de impresora de red.
PRINTER_ATTRIBUTE_PUBLISHED	Indica si la impresora se publica en el servicio de directorio.
PRINTER_ATTRIBUTE_QUEUED	Si se establece, la impresora se pone en cola e inicia la impresión después de la última página. Si no se establece y PRINTER_ATTRIBUTE_DIRECT no se establece, la impresora se imprime y se imprime mientras se agrupa.
PRINTER_ATTRIBUTE_RAW_ONLY	Indica que solo se pueden agrupar trabajos de impresión de tipos de datos sin procesar.
PRINTER_ATTRIBUTE_SHARED	Se comparte la impresora.

En Windows XP y versiones posteriores de Windows, también se puede usar el siguiente valor.

Valor	Significado
PRINTER_ATTRIBUTE_FAX	Si se establece, la impresora es una impresora de fax. Esto solo se puede establecer mediante AddPrinter, pero Puede recuperarlo EnumPrinters y GetPrinter.

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

Valor	Significado
PRINTER_ATTRIBUTE_FRIENDLY_NAME	Un equipo se ha conectado a esta impresora y le ha dado un nombre descriptivo.
PRINTER_ATTRIBUTE_MACHINE	La impresora es una conexión por máquina.
PRINTER_ATTRIBUTE_PUSHED_USER	La impresora se instaló mediante la directiva de usuario Push Printer Connections.
PRINTER_ATTRIBUTE_PUSHED_MACHINE	La impresora se instaló mediante la directiva de equipo Push Printer Connections.

En Windows Server 2003, también se puede usar el siguiente valor.

Valor	Significado
PRINTER_ATTRIBUTE_TS	Indica que la impresora está conectada actualmente a través de un servidor de terminal.

Prioridad

Valor de prioridad que usa el administrador de trabajos de impresión para enrutar los trabajos de impresión.

DefaultPriority

Valor de prioridad predeterminado asignado a cada trabajo de impresión.

StartTime

La primera vez en que la impresora imprimirá un trabajo. Este valor se expresa como minutos transcurridos desde las 12:00 GMT (hora media de Greenwich).

UntilTime

La hora más reciente en la que la impresora imprimirá un trabajo. Este valor se expresa como minutos transcurridos desde las 12:00 GMT (hora media de Greenwich).

Estado

Estado de la impresora. Este miembro puede ser cualquier combinación razonable de los siguientes valores.

Valor	Significado
PRINTER_STATUS_BUSY	La impresora está ocupada.
PRINTER_STATUS_DOOR_OPEN	La puerta de la impresora está abierta.
PRINTER_STATUS_ERROR	La impresora está en un estado de error.
PRINTER_STATUS_INITIALIZING	La impresora se está inicializando.
PRINTER_STATUS_IO_ACTIVE	La impresora está en un estado de entrada/salida activo.
PRINTER_STATUS_MANUAL_FEED	La impresora está en estado de alimentación manual.
PRINTER_STATUS_NO_TONER	Se ha agotado el tóner de la impresora.
PRINTER_STATUS_NOT_AVAILABLE	La impresora no está disponible para imprimir.
PRINTER_STATUS_OFFLINE	La impresora no está conectada.
PRINTER_STATUS_OUT_OF_MEMORY	La impresora se ha quedado sin memoria.
PRINTER_STATUS_OUTPUT_BIN_FULL	La bandeja de salida de la impresora está llena.
PRINTER_STATUS_PAGE_PUNT	La impresora no puede imprimir la página actual.
PRINTER_STATUS_PAPER_JAM	El papel está atascado en la impresora
PRINTER_STATUS_PAPER_OUT	La impresora se ha quedado sin papel.
PRINTER_STATUS_PAPER_PROBLEM	La impresora tiene un problema de papel.
PRINTER_STATUS_PAUSED	La impresora está en pausa.
PRINTER_STATUS_PENDING_DELETION	Se está eliminando la impresora.
PRINTER_STATUS_POWER_SAVE	La impresora está en modo de ahorro de energía.
PRINTER_STATUS_PRINTING	La impresora está imprimiendo.
PRINTER_STATUS_PROCESSING	La impresora está procesando un trabajo de impresión.
PRINTER_STATUS_SERVER_UNKNOWN	El estado de la impresora es desconocido.
PRINTER_STATUS_TONER_LOW	La impresora está baja en tóner.
PRINTER_STATUS_USER_INTERVENTION	La impresora tiene un error que requiere que el usuario haga algo.
PRINTER_STATUS_WAITING	La impresora está esperando.
PRINTER_STATUS_WARMING_UP	La impresora se está preparando.

cJobs

Número de trabajos de impresión que se han puesto en cola para la impresora.

AveragePPM

Número medio de páginas por minuto que se han impreso en 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	_PRINTER_INFO_2W (Unicode) y _PRINTER_INFO_2A (ANSI)

Consulte también

Impresión
Imprimir estructuras de API de Spooler
DEVMODE
EnumPrinters
PRINTER_INFO_1
PRINTER_INFO_3
PRINTER_INFO_4
SECURITY_DESCRIPTOR

Compartir a través de