Win32_PrinterDriver-Klasse

Die Win32_PrinterDriverWMI-Klasse stellt die Treiber für eine Win32_Printer instance dar.

Die folgende Syntax wird vom MOF-Code (Managed Object Format) vereinfacht und enthält alle geerbten Eigenschaften, schließt jedoch Methoden aus. Referenzinformationen zu Methoden finden Sie in der Tabelle der Methoden in diesem Thema.

Syntax

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;
};

Member

Die Win32_PrinterDriver-Klasse verfügt über folgende Membertypen:

Methoden

Die Win32_PrinterDriver-Klasse verfügt über diese Methoden.

Methode BESCHREIBUNG
AddPrinterDriver Erstellt einen neuen Druckertreiber.
Startservice Startet den Druckdienst.
StopService Beendet den Druckdienst.

 

Eigenschaften

Die Win32_PrinterDriver-Klasse verfügt über diese Eigenschaften.

Caption

Datentyp: string

Zugriffstyp: Schreibgeschützt

Qualifizierer: MaxLen (64), DisplayName ("Caption")

Kurze Beschreibung des Objekts – eine einzeilige Zeichenfolge.

Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

Configfile

Datentyp: string

Zugriffstyp: Schreibgeschützt

Konfigurationsdatei für diesen Druckertreiber.

Beispiel: "pscrptui.dll"

CreationClassName

Datentyp: string

Zugriffstyp: Schreibgeschützt

Qualifizierer: CIM_Key, DisplayName ("Klassenname")

Name der Klasse oder Unterklasse, die bei der Erstellung einer instance verwendet wird. Bei Verwendung mit den anderen Schlüsseleigenschaften dieser Klasse ermöglicht diese Eigenschaft die eindeutige Identifizierung aller Instanzen dieser Klasse und ihrer Unterklassen.

Diese Eigenschaft wird von CIM_Service geerbt.

Datafile

Datentyp: string

Zugriffstyp: Schreibgeschützt

Qualifizierer: ModelCorrespondence (CIM_DataFile.FileName)

Datendatei für diesen Druckertreiber.

Beispiel: "qms810.ppd"

DefaultDataType

Datentyp: string

Zugriffstyp: Schreibgeschützt

Standarddatentyp für diesen Druckertreiber.

Beispiel: "EMF"

DependentFiles

Datentyp: Zeichenfolgenarray

Zugriffstyp: Schreibgeschützt

Array von abhängigen Dateien für diesen Druckertreiber.

Beschreibung

Datentyp: string

Zugriffstyp: Schreibgeschützt

Qualifizierer: DisplayName ("Description")

Kommentar, der den Link beschreibt.

Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

DriverPath

Datentyp: string

Zugriffstyp: Schreibgeschützt

Qualifizierer: ModelCorrespondence (CIM_DataFile.Path)

Pfad für diesen Druckertreiber.

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

FilePath

Datentyp: string

Zugriffstyp: Lese-/Schreibzugriff

Pfad zur verwendeten INF-Datei.

Beispiel: "c:\\temp\\driver"

Helpfile

Datentyp: string

Zugriffstyp: Schreibgeschützt

Hilfedatei für diesen Druckertreiber.

Beispiel: "pscrptui.hlp"

InfName

Datentyp: string

Zugriffstyp: Lese-/Schreibzugriff

Name der verwendeten INF-Datei. Standardmäßig wird eine vom Betriebssystem bereitgestellte INF-Druckerdatei verwendet. Ein anderer Dateiname wird verwendet, wenn der Treiber direkt vom Hersteller des Druckers und nicht vom Betriebssystem bereitgestellt wird.

InstallDate

Datentyp: datetime

Zugriffstyp: Schreibgeschützt

Qualifizierer: MappingStrings ("MIF. DMTF| ComponentID|001.5"), DisplayName ("Installationsdatum")

Datum und Uhrzeit der Installation des Objekts. Für diese Eigenschaft ist kein Wert erforderlich, um anzugeben, dass das Objekt installiert ist.

Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

MonitorName

Datentyp: string

Zugriffstyp: Schreibgeschützt

Name des Monitors für diesen Druckertreiber.

Beispiel: "PJL-Monitor"

Name

Datentyp: string

Zugriffstyp: Schreibgeschützt

Qualifizierer: Schlüssel

Treibername für diesen Drucker. Dies ist ein zusammengesetzter Schlüssel, der aus den Werten Name, Version und SupportedPlatform besteht.

Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt und setzt die Name-Definition in dieser Klasse außer Kraft.

OEMUrl

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Link zum World Wide Web (WWW) zur Website des Druckerherstellers. Beachten Sie, dass diese Eigenschaft nicht aufgefüllt wird, wenn die Datei Win32.inf verwendet wird, und nur für Treiber gilt, die direkt vom Hersteller bereitgestellt werden.

Started

Datentyp: Boolesch

Zugriffstyp: Schreibgeschützt

Qualifizierer: DisplayName ("Started")

Wenn TRUE, wird der Dienst gestartet. Bei FALSE wird der Dienst beendet.

Diese Eigenschaft wird von CIM_Service geerbt.

StartMode

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Qualifizierer: DisplayName ("Startmodus")

Der Startmodus des Diensts wird automatisch von einem Betriebssystem gestartet oder nur auf Anforderung gestartet.

Diese Eigenschaft wird von CIM_Service geerbt.

Folgende Werte sind möglich:

"Automatisch"
"Manuell"

Automatisch ("Automatisch")

Manuell ("Manuell")

Status

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Qualifizierer: MaxLen (10), DisplayName ("Status")

Aktuelle status des Objekts. Es können verschiedene betriebs- und nicht-operative Status definiert werden. Zu den Betriebsstatus gehören: "OK", "Degraded" und "Pred Fail" (ein Element, z. B. ein SMART-fähiges Festplattenlaufwerk, funktioniert möglicherweise ordnungsgemäß, sagt aber einen Fehler in naher Zukunft voraus). Zu den nicht betriebsrelevanten Status zählen : "Error", "Starting", "Stop" und "Service". Letzteres, "Dienst", kann während Spiegel des Wiederverwendens eines Datenträgers, beim Erneutladen einer Benutzerberechtigungsliste oder bei anderen Administrativen Arbeiten angewendet werden. Nicht alle derartigen Arbeiten sind online, aber das verwaltete Element ist weder "OK" noch in einem der anderen Zuständen.

Diese Eigenschaft wird von CIM_ManagedSystemElement geerbt.

Folgende Werte sind gültig:

OK ("OK")

Fehler ("Fehler")

Degraded ("Degraded")

Unbekannt ("Unbekannt")

Pred Fail ("Pred Fail")

Starten ("Start")

Beenden ("Beenden")

Dienst ("Dienst")

Gestresst ("Gestresst")

NonRecover ("NonRecover")

Kein Kontakt ("Kein Kontakt")

Lost Comm ("Lost Comm")

SupportedPlatform

Datentyp: Zeichenfolge

Zugriffstyp: Lese-/Schreibzugriff

Betriebsumgebungen, für die der Treiber vorgesehen ist.

Beispiel: "Windows NT x86".

SystemCreationClassName

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Qualifizierer: Weitergegeben ("CIM_System. CreationClassName"), CIM_Key, DisplayName ("Systemklassenname")

Der Name der Erstellungsklasse des Bereichssystems.

Diese Eigenschaft wird von CIM_Service geerbt.

Systemname

Datentyp: Zeichenfolge

Zugriffstyp: Schreibgeschützt

Qualifizierer: Weitergegeben ("CIM_System. Name"), CIM_Key, DisplayName ("Systemname")

Name des Systems, das diesen Dienst hostet.

Diese Eigenschaft wird von CIM_Service geerbt.

Version

Datentyp: uint16

Zugriffstyp: Lese-/Schreibzugriff

Betriebssystemversion für den Druckertreiber.

3

Win2k

Bemerkungen

Die Win32_PrinterDriver-Klasse wird von CIM_Service abgeleitet, die von CIM_LogicalElement abgeleitet ist.

Benutzer können einen Druckertreiber deinstallieren, indem sie eine entsprechende instance dieser Klasse löschen. Dazu muss für den aufrufenden Prozess die SeLoadDriverPrivilege-Berechtigung festgelegt sein, um eine instance dieser Klasse zu löschen.

Beispiele

Im VBScript-Beispiel Drucker- und Druckertreiber verwalten werden Druckertreiber und Druckerports verwaltet.

In der folgenden Diskussion in den TechNet-Foren wird beschrieben, wie Sie einen Drucker erstellen und Treiber von einem Server hochladen.

Im folgenden VBScript-Beispiel werden alle Druckertreiber aufgelistet, die auf einem Computer installiert wurden.

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 

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows Vista
Unterstützte Mindestversion (Server)
WindowsServer 2008
Namespace
Root\CIMV2
MOF
Win32_Printer.mof
DLL
CIMWin32.dll

Siehe auch

CIM_Service

Hardwareklassen des Computersystems