Win32_PrinterDriver-Klasse

Artikel
06/12/2023

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
Eigenschaften

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.

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

Freigeben über

Win32_PrinterDriver-Klasse

Syntax

Member

Methoden

Eigenschaften

Bemerkungen

Beispiele

Anforderungen

Siehe auch

Feedback

Zusätzliche Ressourcen