Win32 _ PrinterDriver-Klasse

Die WMI-Klasse _ Win32 PrinterDriver stellt die Treiber für eine Win32-Druckerinstanz _ dar.

Die folgende Syntax wird von 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 die folgenden 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 einzeilenbasierte 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-Schlüssel, DisplayName ("Klassenname")

Name der Klasse oder Unterklasse, die bei der Erstellung einer Instanz verwendet wird. Bei Verwendung mit den anderen Schlüsseleigenschaften dieser Klasse ermöglicht diese Eigenschaft, dass alle Instanzen dieser Klasse und deren Unterklassen eindeutig identifiziert werden.

Diese Eigenschaft wird vom CIM-Dienst _ 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: \ \ Treiber \ \pscript.dll"

Filepath

Datentyp: string

Zugriffstyp: Lesen/Schreiben

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: Lesen/Schreiben

Name der verwendeten INF-Datei. Standardmäßig wird eine vom Betriebssystem bereitgestellte Drucker-INF-Datei 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 ("Installation date")

Datum und Uhrzeit der Installation des Objekts. Diese Eigenschaft erfordert keinen Wert, 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 überschreibt die Name-Definition in dieser Klasse.

OEMUrl

Datentyp: string

Zugriffstyp: Schreibgeschützt

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

Begann

Datentyp: boolescher Wert

Zugriffstyp: Schreibgeschützt

Qualifizierer: DisplayName ("Started")

True gibt an, dass der Dienst gestartet wird. False gibt an, dass der Dienst beendet wird.

Diese Eigenschaft wird vom _ CIM-Dienstgeerbt.

StartMode

Datentyp: string

Zugriffstyp: Schreibgeschützt

Qualifizierer: DisplayName ("Startmodus")

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

Diese Eigenschaft wird vom _ CIM-Dienstgeerbt.

Folgende Werte sind möglich:

"Automatisch"
"Manuell"

Automatisch ("Automatisch")

Manuell ("Manuell")

Status

Datentyp: string

Zugriffstyp: Schreibgeschützt

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

Aktueller Status des Objekts. Es können verschiedene Betriebs- und Nichtoperationsstatus definiert werden. Betriebsstatus: "OK", "Heruntergestuft" und "Pred Fail" (ein Element, z. B. ein SMART-fähiges Festplattenlaufwerk, funktioniert möglicherweise ordnungsgemäß, sagt aber einen Fehler in naher Zukunft vorher). Nichtoperationale Status: "Error", "Starting", "Stopping" und "Service". Letzteres, "Dienst", kann beim Spiegelungsresilvering eines Datenträgers, beim erneuten Laden einer Benutzerberechtigungsliste oder bei anderen Verwaltungsaufgaben angewendet werden. Nicht alle dieser Arbeiten sind online, aber das verwaltete Element ist weder "OK" noch in einem der anderen Zustände.

Diese Eigenschaft wird von CIM _ ManagedSystemElementgeerbt.

Folgende Werte sind gültig:

OK ("OK")

Fehler ("Fehler")

Heruntergestuft ("Heruntergestuft")

Unbekannt ("Unbekannt")

Pred Fail ("Pred Fail")

Wird gestartet ("Wird gestartet")

Beenden ("Wird beendet")

Dienst ("Dienst")

Mannslast ("1000")

NonRecover ("NonRecover")

Kein Kontakt ("Kein Kontakt")

Verlorenes Komma ("Verlorenes Komma")

SupportedPlatform

Datentyp: string

Zugriffstyp: Lesen/Schreiben

Betriebsumgebungen, für die der Treiber vorgesehen ist.

Beispiel: "Windows NT x86".

SystemCreationClassName

Datentyp: string

Zugriffstyp: Schreibgeschützt

Qualifizierer: Weitergegeben ("_ CIM-System.CreationClassName"), _ CIM-Schlüssel, DisplayName ("Systemklassenname")

Der Name der Erstellungsklasse des Bereichssystems.

Diese Eigenschaft wird vom _ CIM-Dienstgeerbt.

Systemname

Datentyp: string

Zugriffstyp: Schreibgeschützt

Qualifizierer: Weitergegeben ("_ CIM-System.Name"), _ CIM-Schlüssel, DisplayName ("Systemname")

Name des Systems, das diesen Dienst hostet.

Diese Eigenschaft wird vom _ CIM-Dienstgeerbt.

Version

Datentyp: uint16

Zugriffstyp: Lesen/Schreiben

Betriebssystemversion für den Druckertreiber.

3

Win2k

Hinweise

Die Win32 _ PrinterDriver-Klasse wird vom _ CIM-Dienst abgeleitet, der von CIM _ LogicalElementabgeleitet wird.

Benutzer können einen Druckertreiber deinstallieren, indem sie eine entsprechende Instanz dieser Klasse löschen. Hierzu muss für den aufrufenden Prozess die SeLoadDriverPrivilege-Berechtigung festgelegt sein, um eine Instanz 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)
Windows Server 2008
Namespace
\Stamm-CIMV2
MOF
Win32 _ Printer.mof
DLL
CIMWin32.dll

Weitere Informationen

_CIM-Dienst

Computersystemhardwareklassen