Win32_PrinterDriver clase

Artículo
06/03/2023

La clase WMIde Win32_PrinterDriver representa los controladores de una instancia de Win32_Printer.

La sintaxis siguiente se simplifica desde el código de Formato de objeto administrado (MOF) e incluye todas las propiedades heredadas, pero excluye los métodos. Para obtener información de referencia sobre los métodos, vea la tabla de métodos de este tema.

Sintaxis

class Win32_PrinterDriver : CIM_Service
{
  string   Caption;
  string   ConfigFile;
  string   CreationClassName;
  string   DataFile;
  string   DefaultDataType;
  string   DependentFiles[];
  string   Description;
  string   DriverPath;
  string   FilePath;
  string   HelpFile;
  string   InfName;
  datetime InstallDate;
  string   MonitorName;
  string   Name;
  string   OEMUrl;
  boolean  Started;
  string   StartMode;
  string   Status;
  string   SupportedPlatform;
  string   SystemCreationClassName;
  string   SystemName;
  uint16   Version;
};

Miembros

La clase Win32_PrinterDriver tiene estos tipos de miembros:

Métodos
Propiedades

Métodos

La clase Win32_PrinterDriver tiene estos métodos.

Método	Descripción
AddPrinterDriver	Crea un controlador de impresora.
StartService	Inicia el servicio de impresión.
StopService	Detiene el servicio de impresión.

Propiedades

La clase Win32_PrinterDriver tiene estas propiedades.

Caption

Tipo de datos: cadena
Tipo de acceso: solo lectura
Calificadores: MaxLen (64), DisplayName ("Caption")

Descripción breve del objeto: una cadena de una línea.

Esta propiedad se hereda de CIM_ManagedSystemElement.

ConfigFile

Tipo de datos: cadena
Tipo de acceso: solo lectura

Archivo de configuración para este controlador de impresora.

Ejemplo: "pscrptui.dll"

CreationClassName

Tipo de datos: cadena
Tipo de acceso: solo lectura
Calificadores: CIM_Key, DisplayName ("Nombre de clase")

Nombre de la clase o la subclase usada en la creación de una instancia. Cuando se usa con las demás propiedades clave de esta clase, esta propiedad permite identificar todas las instancias de esta clase y sus subclases.

Esta propiedad se hereda de CIM_Service.

DataFile

Tipo de datos: cadena
Tipo de acceso: solo lectura
Calificadores: ModelCorrespondence (CIM_DataFile.FileName)

Archivo de datos para este controlador de impresora.

Ejemplo: "qms810.ppd"

DefaultDataType

Tipo de datos: cadena
Tipo de acceso: solo lectura

Tipo de datos predeterminado para este controlador de impresora.

Ejemplo: "EMF"

DependentFiles

Tipo de datos: matriz de cadenas
Tipo de acceso: solo lectura

Matriz de archivos dependientes para este controlador de impresora.

Descripción

Tipo de datos: cadena
Tipo de acceso: solo lectura
Calificadores: DisplayName ("Descripción")

Comentario que describe el vínculo.

Esta propiedad se hereda de CIM_ManagedSystemElement.

DriverPath

Tipo de datos: cadena
Tipo de acceso: solo lectura
Calificadores: ModelCorrespondence (CIM_DataFile.Path)

Ruta de acceso para este controlador de impresora.

Ejemplo: "C:\\drivers\\pscript.dll"

FilePath

Tipo de datos: cadena
Tipo de acceso: lectura/escritura

Ruta de acceso al archivo INF que se usa.

Ejemplo: "c:\\temp\\driver"

HelpFile

Tipo de datos: cadena
Tipo de acceso: solo lectura

Archivo de ayuda para este controlador de impresora.

Ejemplo: "pscrptui.hlp"

InfName

Tipo de datos: cadena
Tipo de acceso: lectura/escritura

Nombre del archivo INF que se usa. El valor predeterminado es usar un archivo INF de impresora proporcionado por el sistema operativo. Se usa un nombre de archivo diferente si el fabricante de la impresora proporciona directamente el controlador y no el sistema operativo.

InstallDate

Tipo de datos: datetime
Tipo de acceso: solo lectura
Calificadores: MappingStrings ("MIF. DMTF| ComponentID|001.5"), DisplayName ("Fecha de instalación")

Fecha y hora en que se instala el objeto. Esta propiedad no requiere un valor para indicar que el objeto está instalado.

Esta propiedad se hereda de CIM_ManagedSystemElement.

MonitorName

Tipo de datos: cadena
Tipo de acceso: solo lectura

Nombre del monitor para este controlador de impresora.

Ejemplo: "Monitor PJL"

Nombre

Tipo de datos: cadena
Tipo de acceso: solo lectura
Calificadores: Clave

Nombre del controlador para esta impresora. Se trata de una clave compuesta formada por los valores Name, Version y SupportedPlatform .

Esta propiedad se hereda de CIM_ManagedSystemElement e invalida la definición name de esa clase.

OEMUrl

Tipo de datos: cadena
Tipo de acceso: solo lectura

Vínculo a World Wide Web (WWW) al sitio web del fabricante de impresoras. Tenga en cuenta que esta propiedad no se rellena cuando se usa el archivo Win32.inf y solo es aplicable a los controladores proporcionados directamente desde el fabricante.

Introducción

Tipo de datos: booleano
Tipo de acceso: solo lectura
Calificadores: DisplayName ("Started")

Si es TRUE, se inicia el servicio. Si es FALSE, el servicio se detiene.

Esta propiedad se hereda de CIM_Service.

StartMode

Tipo de datos: cadena
Tipo de acceso: solo lectura
Calificadores: DisplayName ("Modo de inicio")

Un sistema operativo inicia automáticamente el modo de inicio del servicio o solo se inicia cuando se solicita.

Esta propiedad se hereda de CIM_Service.

Estos son los valores posibles:

"Automático"

"Manual"

Automático ("Automático")

Manual ("Manual")

Estado

Tipo de datos: cadena
Tipo de acceso: solo lectura
Calificadores: MaxLen (10), DisplayName ("Status")

Estado actual del objeto. Se pueden definir varios estados operativos y no operativos. Los estados operativos incluyen: "Ok", "Degradado" y "Error previo" (un elemento, como una unidad de disco duro habilitada para SMART, puede funcionar correctamente, pero predecir un error en un futuro próximo). Los estados no operativos incluyen: "Error", "Inicio", "Detención" y "Servicio". Este último, "Servicio", se puede aplicar durante la resilveración de reflejo de un disco, la recarga de una lista de permisos de usuario u otro trabajo administrativo. No todo este trabajo está en línea, pero el elemento administrado no es "CORRECTO" ni en uno de los otros estados.

Esta propiedad se hereda de CIM_ManagedSystemElement.

Los valores son los siguientes:

Ok ("OK")

Error ("Error")

Degradado ("Degradado")

Desconocido ("Desconocido")

Error previo ("Error previo")

Inicio ("Inicio")

Detener ("Detener")

Servicio ("Servicio")

Estresado ("Estresado")

NonRecover ("NonRecover")

Sin contacto ("Sin contacto")

Lost Comm ("Lost Comm")

SupportedPlatform

Tipo de datos: cadena
Tipo de acceso: lectura/escritura

Entornos operativos para los que está destinado el controlador.

Ejemplo: "Windows NT x86".

SystemCreationClassName

Tipo de datos: cadena
Tipo de acceso: solo lectura
Calificadores: propagados ("CIM_System. CreationClassName"), CIM_Key, DisplayName ("Nombre de clase del sistema")

Nombre de la clase de creación del sistema de ámbito.

Esta propiedad se hereda de CIM_Service.

SystemName

Tipo de datos: cadena
Tipo de acceso: solo lectura
Calificadores: propagados ("CIM_System. Name"), CIM_Key, DisplayName ("Nombre del sistema")

Nombre del sistema que hospeda este servicio.

Esta propiedad se hereda de CIM_Service.

Versión

Tipo de datos: uint16
Tipo de acceso: lectura/escritura

Versión del sistema operativo para el controlador de impresora.

Win2k

Comentarios

La clase Win32_PrinterDriver se deriva de CIM_Service que se deriva de CIM_LogicalElement.

Los usuarios pueden desinstalar un controlador de impresora eliminando una instancia correspondiente de esta clase. Para ello, el proceso de llamada debe tener el privilegio SeLoadDriverPrivilege establecido para eliminar una instancia de esta clase.

Ejemplos

El ejemplo Administrar controladores de impresora e impresora VBScript administra los controladores de impresora y los puertos de impresora.

En la siguiente discusión en los foros de TechNet se describe cómo crear una impresora y cargar controladores desde un servidor.

En el siguiente ejemplo de VBScript se enumeran todos los controladores de impresora que se han instalado en un equipo.

strComputer = "." 
Set objWMIService = GetObject("winmgmts:" _ 
    & "{impersonationLevel=impersonate}!\\" & strComputer & "\root\cimv2") 
Set colInstalledPrinters =  objWMIService.ExecQuery _ 
    ("Select * from Win32_PrinterDriver") 
 
For each objPrinter in colInstalledPrinters 
    Wscript.Echo "Configuration File: " & objPrinter.ConfigFile 
    Wscript.Echo "Data File: " & objPrinter.DataFile 
    Wscript.Echo "Description: " & objPrinter.Description 
    Wscript.Echo "Driver Path: " & objPrinter.DriverPath 
    Wscript.Echo "File Path: " & objPrinter.FilePath 
    Wscript.Echo "Help File: " & objPrinter.HelpFile 
    Wscript.Echo "INF Name: " & objPrinter.InfName 
    Wscript.Echo "Monitor Name: " & objPrinter.MonitorName 
    Wscript.Echo "Name: " & objPrinter.Name 
    Wscript.Echo "OEM Url: " & objPrinter.OEMUrl 
    Wscript.Echo "Supported Platform: " & objPrinter.SupportedPlatform 
    Wscript.Echo "Version: " & objPrinter.Version 
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_Service
Clases de hardware del sistema de equipos

Win32_PrinterDriver clase

Sintaxis

Miembros

Métodos

Propiedades

Comentarios

Ejemplos

Requisitos

Consulte también

Comentarios

Comentarios

Recursos adicionales