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