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 |
|
| DLL |
|