Win32_PrinterConfiguration clase

Artículo
06/03/2023

La Win32_PrinterConfigurationclase WMI representa la configuración de un dispositivo de impresora. Esto incluye funcionalidades como la resolución, el color, las fuentes y la orientación.

La siguiente sintaxis se simplifica desde el código de Managed Object Format (MOF) e incluye todas las propiedades heredadas. Las propiedades se enumeran en orden alfabético, no en orden MOF.

Sintaxis

class Win32_PrinterConfiguration : CIM_Setting
{
  string  Caption;
  string  Description;
  string  SettingID;
  uint32  BitsPerPel;
  boolean Collate;
  uint32  Color;
  uint32  Copies;
  string  DeviceName;
  uint32  DisplayFlags;
  uint32  DisplayFrequency;
  uint32  DitherType;
  uint32  DriverVersion;
  boolean Duplex;
  string  FormName;
  uint32  HorizontalResolution;
  uint32  ICMIntent;
  uint32  ICMMethod;
  uint32  LogPixels;
  uint32  MediaType;
  string  Name;
  uint32  Orientation;
  uint32  PaperLength;
  string  PaperSize;
  uint32  PaperWidth;
  uint32  PelsHeight;
  uint32  PelsWidth;
  uint32  PrintQuality;
  uint32  Scale;
  uint32  SpecificationVersion;
  uint32  TTOption;
  uint32  VerticalResolution;
  uint32  XResolution;
  uint32  YResolution;
};

Miembros

La clase Win32_PrinterConfiguration tiene estos tipos de miembros:

Propiedades

Propiedades

La clase Win32_PrinterConfiguration tiene estas propiedades.

BitsPerPel

Tipo de datos: uint32
Tipo de acceso: solo lectura
Calificadores: en desuso

Número de bits usados para representar el color de esta configuración (los bits por píxel). Esta propiedad ha quedado obsoleta. En su lugar, use propiedades en las clases Win32_VideoController, Win32_DesktopMonitor o CIM_VideoControllerResolution para determinar cómo se representa el color.

Caption

Tipo de datos: cadena
Tipo de acceso: solo lectura
Calificadores: MaxLen (64)

Breve descripción textual del objeto actual.

Esta propiedad se hereda de CIM_Setting.

Intercalar

Tipo de datos: booleano
Tipo de acceso: solo lectura

Si es TRUE, se deben intercalar las páginas que se imprimen. Para intercalar es imprimir todo el documento antes de imprimir la siguiente copia, en lugar de imprimir cada página del documento el número necesario de veces.

Esta propiedad se omite a menos que el controlador de impresora indique la compatibilidad con la intercalación.

Color

Tipo de datos: uint32
Tipo de acceso: solo lectura

Color del documento. Algunas impresoras de color tienen la capacidad de imprimir utilizando negro verdadero en lugar de una combinación de cian, magenta y amarillo (CMY). Normalmente, esto crea texto más oscuro y más nitidez para los documentos. Esta opción solo es útil para las impresoras de color que admiten la impresión negra verdadera.

1

Monocromo (verdadero negro)

2

Color

Copias

Tipo de datos: uint32
Tipo de acceso: solo lectura

Número de copias que se van a imprimir. El controlador de impresora debe admitir la impresión de copias de varias páginas.

Ejemplo: 2

Descripción

Tipo de datos: cadena
Tipo de acceso: solo lectura

Descripción textual del objeto actual.

Esta propiedad se hereda de CIM_Setting.

DeviceName

Tipo de datos: cadena
Tipo de acceso: solo lectura

Nombre descriptivo de la impresora. Este nombre es único para el tipo de impresora y se puede truncar debido a las limitaciones de la cadena desde la que se deriva.

Ejemplo: "PCL/HP LaserJet"

DisplayFlags

Tipo de datos: uint32
Tipo de acceso: solo lectura

Indica si el dispositivo de pantalla es de color o monocromo y si el tipo de escaneo no está entrelazado o entrelazado. Esta propiedad ha quedado obsoleta. En su lugar, use propiedades para mostrar como la propiedad DisplayType de la clase Win32_DesktopMonitor .

DisplayFrequency

Tipo de datos: uint32
Tipo de acceso: solo lectura

Muestra la frecuencia de actualización vertical. La frecuencia de actualización de un monitor es el número de veces que se vuelve a dibujar la pantalla por segundo (frecuencia). Esta propiedad ha quedado obsoleta. En su lugar, use las propiedades de la clase Win32_VideoController, Win32_DesktopMonitor o CIM_VideoControllerResolution .

DitherType

Tipo de datos: uint32
Tipo de acceso: solo lectura

Tipo de dither de la impresora. Esta propiedad puede suponer valores predefinidos de 1 a 5 o valores definidos por el controlador de 6 a 256. El dithering de arte de líneas es un método especial de dithering que produce bordes bien definidos entre escalas negras, blancas y grises. No es adecuado para imágenes que incluyan graduaciones continuas en intensidad y matiz, como fotografías escaneadas.

Sin dithering

Pincel grueso

Pincel fino

Gráfico de líneas

Escala de grises

DriverVersion

Tipo de datos: uint32
Tipo de acceso: solo lectura

Número de versión del controlador de impresora basado en Windows. El fabricante del controlador crea y mantiene los números de versión.

Dúplex

Tipo de datos: booleano
Tipo de acceso: solo lectura

Si es TRUE, la impresión se realiza en ambos lados. Si es FALSE, la impresión se realiza solo en un lado del medio.

FormName

Tipo de datos: cadena
Tipo de acceso: solo lectura

No compatible.

HorizontalResolution

Tipo de datos: uint32
Tipo de acceso: solo lectura
Calificadores: unidades (puntos por pulgada)

Resolución de impresión en puntos por pulgada a lo largo del eje X (ancho) del trabajo de impresión (similar a la propiedad XResolution obsoleta). Este valor solo se establece cuando la propiedad PrintQuality de esta clase es positiva.

ICMIntent

Tipo de datos: uint32
Tipo de acceso: solo lectura

Valor específico de uno de los tres métodos posibles de coincidencia de colores (denominados intenciones) que se deben usar de forma predeterminada. Las aplicaciones ICM establecen intenciones mediante las funciones ICM. Esta propiedad puede suponer valores predefinidos de 1 a 3 o valores definidos por el controlador de 4 a 256. Las aplicaciones que no son ICM pueden usar este valor para determinar cómo controla la impresora los trabajos de impresión de color.

Saturación

Compare

Color exacto

ICMMethod

Tipo de datos: uint32
Tipo de acceso: solo lectura

Cómo se controla ICM. Para una aplicación que no es ICM, esta propiedad determina si ICM está habilitado o deshabilitado. En el caso de las aplicaciones ICM, el sistema examina esta propiedad para determinar qué parte del sistema informático controla la compatibilidad con ICM.

Disabled

Windows

Controlador de dispositivo

Dispositivo

LogPixels

Tipo de datos: uint32
Tipo de acceso: solo lectura
Calificadores: en desuso

Número de píxeles por pulgada lógica. Esta propiedad obsoleta solo es válida con dispositivos que funcionan con píxeles, que excluyen dispositivos como impresoras. No hay ningún valor de reemplazo que se aplique a las impresoras.

MediaType

Tipo de datos: uint32
Tipo de acceso: solo lectura

Tipo de medio en el que se imprime la impresora. La propiedad se puede establecer en un valor predefinido o en un valor definido por el controlador mayor o igual que 256.

Estándar

Transparencia

Brillante

Nombre

Tipo de datos: cadena
Tipo de acceso: solo lectura
Calificadores: Key, MaxLen (256)

Nombre de la impresora con la que está asociada esta configuración. Este valor coincide con la propiedad Name de la instancia de Win32_Printer asociada.

Orientación

Tipo de datos: uint32
Tipo de acceso: solo lectura

Orientación de impresión del papel.

Vertical

Horizontal

PaperLength

Tipo de datos: uint32
Tipo de acceso: solo lectura
Calificadores: Unidades (Décimas de milímetro)

Longitud del papel. Para determinar el tamaño del papel en pulgadas, divida este valor en 254.

Ejemplo: 2794

PaperSize

Tipo de datos: cadena
Tipo de acceso: solo lectura

Tamaño del papel. Los tamaños posibles se encuentran en la propiedad PaperSizesSupported de la clase Win32_Printer asociada.

Ejemplo: "A4 o letra".

PaperWidth

Tipo de datos: uint32
Tipo de acceso: solo lectura
Calificadores: Unidades (Décimas de milímetro)

Ancho del papel. Para determinar el tamaño del papel en pulgadas, divida este valor en 254.

Ejemplo: 2159

PelsHeight

Tipo de datos: uint32
Tipo de acceso: solo lectura
Calificadores: en desuso

Esta propiedad no es compatible.

PelsWidth

Tipo de datos: uint32
Tipo de acceso: solo lectura
Calificadores: en desuso

Esta propiedad no es compatible.

PrintQuality

Tipo de datos: uint32
Tipo de acceso: solo lectura

Uno de los cuatro niveles de calidad del trabajo de impresión. Si se especifica un valor positivo, la calidad se mide en puntos por pulgada.

-1

Borrador

-2

Bajo

-3

Media

-4

Alto

Escala

Tipo de datos: uint32
Tipo de acceso: solo lectura
Calificadores: unidades (porcentaje)

Factor por el que se va a escalar la salida impresa. Por ejemplo, una escala de 75 reduce la salida de impresión a 3/4 su alto y ancho originales.

SettingID

Tipo de datos: cadena
Tipo de acceso: solo lectura
Calificadores: MaxLen (256)

Identificador por el que se conoce el objeto actual.

Esta propiedad se hereda de CIM_Setting.

SpecificationVersion

Tipo de datos: uint32
Tipo de acceso: solo lectura

Número de versión de los datos de inicialización del dispositivo asociado a la impresora basada en Windows.

TTOption

Tipo de datos: uint32
Tipo de acceso: solo lectura

Indica cómo se deben imprimir las fuentes TrueType.

Mapa de bits (1)

Imprime fuentes TrueType como gráficos. Esta es la acción predeterminada para las impresoras dot-matrix.

Descargar (2)

Descarga fuentes TrueType como fuentes suaves. Esta es la acción predeterminada para las impresoras que usan el lenguaje de control de impresoras (PCL).

Sustituto (3)

Sustituye las fuentes del dispositivo para las fuentes TrueType. Esta es la acción predeterminada para las impresoras PostScript.

VerticalResolution

Tipo de datos: uint32
Tipo de acceso: solo lectura
Calificadores: unidades (puntos por pulgada)

Resolución de impresión a lo largo del eje Y (alto) del trabajo de impresión (similar a la propiedad YResolution obsoleta). Este valor solo se establece cuando la propiedad PrintQuality de esta clase es positiva.

XResolution

Tipo de datos: uint32
Tipo de acceso: solo lectura
Calificadores: en desuso

Esta propiedad ha quedado obsoleta. Utilice la propiedad HorizontalResolution en su lugar.

YResolution

Tipo de datos: uint32
Tipo de acceso: solo lectura
Calificadores: en desuso

Esta propiedad ha quedado obsoleta. Utilice la propiedad VerticalResolution en su lugar.

Comentarios

La clase Win32_PrinterConfiguration se deriva de CIM_Setting.

Información general

Para poder determinar cómo distribuir y usar mejor los recursos de impresión, debe tener un conocimiento detallado de esos recursos. Por ejemplo, el Departamento A podría tener solo tres impresoras en comparación con cinco impresoras en el Departamento B. Sin embargo, si las impresoras del Departamento A pueden imprimir 20 páginas por minuto y las impresoras del Departamento B pueden imprimir solo 5 páginas por minuto, los usuarios del Departamento A realmente tienen más capacidad de impresión. Sin conocer las funcionalidades detalladas de estas impresoras, podría concluir erróneamente que el Departamento A es corto en la capacidad de impresión y, por lo tanto, comprar impresoras adicionales que terminen sin usarse.

WMI incluye dos clases, Win32_Printer y Win32_PrinterConfiguration, que se pueden usar para devolver información detallada sobre todas las impresoras instaladas en un equipo.

Ejemplos

En el ejemplo de código siguiente se recupera la información de la impresora.

strComputer = "."
Set objWMIService = GetObject("winmgmts:" _
 & "{impersonationLevel=impersonate}!\\" & strComputer & "\root\cimv2")
Set colInstalledPrinters = objWMIService.ExecQuery _
 ("SELECT * FROM Win32_PrinterConfiguration")
For Each objPrinter in colInstalledPrinters
 Wscript.Echo "Name: " & objPrinter.Name
 Wscript.Echo "Collate: " & objPrinter.Collate
 Wscript.Echo "Copies: " & objPrinter.Copies
 Wscript.Echo "Driver Version: " & objPrinter.DriverVersion
 Wscript.Echo "Duplex: " & objPrinter.Duplex
 Wscript.Echo "Horizontal Resolution: " & _
 objPrinter.HorizontalResolution
 If objPrinter.Orientation = 1 Then
 strOrientation = "Portrait"
 Else
 strOrientation = "Landscape"
 End If
 Wscript.Echo "Orientation : " & strOrientation
 Wscript.Echo "Paper Length: " & objPrinter.PaperLength / 254
 Wscript.Echo "Paper Width: " & objPrinter.PaperWidth / 254
 Wscript.Echo "Print Quality: " & objPrinter.PrintQuality
 Wscript.Echo "Scale: " & objPrinter.Scale
 Wscript.Echo "Specification Version: " & _
 objPrinter.SpecificationVersion
 If objPrinter.TTOption = 1 Then
 strTTOption = "Print TrueType fonts as graphics."
 ElseIf objPrinter.TTOption = 2 Then
 strTTOption = "Download TrueType fonts as soft fonts."
 Else
 strTTOption = "Substitute device fonts for TrueType fonts."
 End If
 Wscript.Echo "True Type Option: " & strTTOption
 Wscript.Echo "Vertical Resolution: " & objPrinter.VerticalResolution
Next

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista
Servidor mínimo compatible	Windows Server 2008
Espacio de nombres	Root\CIMV2
MOF	Win32_Printer.mof
Archivo DLL	CIMWin32.dll

Consulte también

CIM_Setting
Clases de hardware del sistema de equipos

Win32_PrinterConfiguration clase

Sintaxis

Miembros

Propiedades

Comentarios

Ejemplos

Requisitos

Consulte también

Comentarios

Comentarios

Recursos adicionales