classe Win32_PrinterDriver

Artigo
06/03/2023

A classe WMIWin32_PrinterDriver representa os drivers de uma instância de Win32_Printer.

A sintaxe a seguir é simplificada do código MOF (Managed Object Format) e inclui todas as propriedades herdadas, mas exclui métodos. Para obter informações de referência sobre métodos, consulte a tabela de métodos neste tópico.

Sintaxe

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

Membros

A classe Win32_PrinterDriver tem estes tipos de membros:

Métodos
Propriedades

Métodos

A classe Win32_PrinterDriver tem esses métodos.

Método	Descrição
AddPrinterDriver	Cria um novo driver de impressora.
Startservice	Inicia o serviço de impressão.
StopService	Interrompe o serviço de impressão.

Propriedades

A classe Win32_PrinterDriver tem essas propriedades.

Legenda

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura
Qualificadores: MaxLen (64), DisplayName ("Caption")

Descrição curta do objeto — uma cadeia de caracteres de uma linha.

Essa propriedade é herdada de CIM_ManagedSystemElement.

ConfigFile

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura

Arquivo de configuração para este driver de impressora.

Exemplo: "pscrptui.dll"

CreationClassName

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura
Qualificadores: CIM_Key, DisplayName ("Nome da Classe")

Nome da classe ou da subclasse usada na criação de uma instância. Quando usada com as outras propriedades principais dessa classe, essa propriedade permite que todas as instâncias dessa classe e suas subclasses sejam identificadas exclusivamente.

Essa propriedade é herdada de CIM_Service.

Datafile

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura
Qualificadores: ModelCorrespondence (CIM_DataFile.FileName)

Arquivo de dados para este driver de impressora.

Exemplo: "qms810.ppd"

DefaultDataType

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura

Tipo de dados padrão para este driver de impressora.

Exemplo: "EMF"

DependentFiles

Tipo de dados: matriz de cadeia de caracteres
Tipo de acesso: Somente leitura

Matriz de arquivos dependentes para este driver de impressora.

Descrição

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura
Qualificadores: DisplayName ("Description")

Comentário que descreve o link.

Essa propriedade é herdada de CIM_ManagedSystemElement.

DriverPath

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura
Qualificadores: ModelCorrespondence (CIM_DataFile.Path)

Caminho para este driver de impressora.

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

FilePath

Tipo de dados: cadeia de caracteres
Tipo de acesso: leitura/gravação

Caminho para o arquivo INF que está sendo usado.

Exemplo: "c:\\temp\\driver"

HelpFile

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura

Arquivo de ajuda para este driver de impressora.

Exemplo: "pscrptui.hlp"

InfName

Tipo de dados: cadeia de caracteres
Tipo de acesso: leitura/gravação

Nome do arquivo INF que está sendo usado. O padrão é usar um arquivo INF fornecido pelo sistema operacional. Um nome de arquivo diferente será usado se o driver for fornecido diretamente pelo fabricante da impressora e não pelo sistema operacional.

InstallDate

Tipo de dados: datetime
Tipo de acesso: Somente leitura
Qualificadores: MappingStrings ("MIF. DMTF| ComponentID|001.5"), DisplayName ("Data de Instalação")

Data e hora em que o objeto é instalado. Essa propriedade não requer um valor para indicar que o objeto está instalado.

Essa propriedade é herdada de CIM_ManagedSystemElement.

MonitorName

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura

Nome do monitor para este driver de impressora.

Exemplo: "Monitor PJL"

Nome

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura
Qualificadores: Chave

Nome do driver para esta impressora. Essa é uma chave composta pelos valores Name, Version e SupportedPlatform .

Essa propriedade é herdada de CIM_ManagedSystemElement e substitui a definição name nessa classe.

OEMUrl

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura

Link da World Wide Web (WWW) para o site do fabricante da impressora. Observe que essa propriedade não é preenchida quando o arquivo Win32.inf é usado e só é aplicável para drivers fornecidos diretamente do fabricante.

Iniciado

Tipo de dados: booliano
Tipo de acesso: Somente leitura
Qualificadores: DisplayName ("Iniciado")

Se TRUE, o serviço será iniciado. Se FALSE, o serviço será interrompido.

Essa propriedade é herdada de CIM_Service.

StartMode

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura
Qualificadores: DisplayName ("Modo de Início")

O modo de início do serviço é iniciado automaticamente por um sistema operacional ou iniciado somente quando solicitado.

Essa propriedade é herdada de CIM_Service.

O valores possíveis são os seguintes:

"Automático"

"Manual"

Automático ("Automático")

Manual ("Manual")

Status

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura
Qualificadores: MaxLen (10), DisplayName ("Status")

Status atual do objeto. Vários status operacionais e não operacionais podem ser definidos. Os status operacionais incluem: "OK", "Degradado" e "Falha de Pred" (um elemento, como uma unidade de disco rígido habilitada para SMART, pode estar funcionando corretamente, mas prevendo uma falha em um futuro próximo). Os status não operacionais incluem: "Erro", "Iniciando", "Parando" e "Serviço". Este último, "Serviço", pode ser aplicado durante espelho-resilvering de um disco, recarregar uma lista de permissões de usuário ou outro trabalho administrativo. Nem todo esse trabalho está online, mas o elemento gerenciado não é "OK" nem em um dos outros estados.

Essa propriedade é herdada de CIM_ManagedSystemElement.

Os valores incluem o seguinte:

OK ("OK")

Erro ("Erro")

Degradado ("Degradado")

Desconhecido ("Desconhecido")

Pred Fail ("Pred Fail")

Iniciando ("Iniciando")

Parando ("Parando")

Serviço ("Serviço")

Estressado ("Estressado")

NonRecover ("NonRecover")

Sem Contato ("Sem Contato")

Lost Comm ("Lost Comm")

SupportedPlatform

Tipo de dados: cadeia de caracteres
Tipo de acesso: leitura/gravação

Ambientes operacionais para os quais o driver se destina.

Exemplo: "Windows NT x86".

SystemCreationClassName

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura
Qualificadores: propagados ("CIM_System. CreationClassName"), CIM_Key, DisplayName ("Nome da Classe do Sistema")

Nome da classe de criação do sistema de escopo.

Essa propriedade é herdada de CIM_Service.

Systemname

Tipo de dados: cadeia de caracteres
Tipo de acesso: Somente leitura
Qualificadores: propagados ("CIM_System. Nome"), CIM_Key, DisplayName ("Nome do Sistema")

Nome do sistema que hospeda esse serviço.

Essa propriedade é herdada de CIM_Service.

Versão

Tipo de dados: uint16
Tipo de acesso: leitura/gravação

Versão do sistema operacional para o driver de impressora.

Win2k

Comentários

A classe Win32_PrinterDriver é derivada de CIM_Service que deriva de CIM_LogicalElement.

Os usuários podem desinstalar um driver de impressora excluindo uma instância correspondente dessa classe. Para fazer isso, o processo de chamada deve ter o privilégio SeLoadDriverPrivilege definido para excluir uma instância dessa classe.

Exemplos

O exemplo Gerenciar Impressora e Drivers de Impressora VBScript gerencia drivers de impressora e portas de impressora.

A discussão a seguir nos fóruns do TechNet descreve como criar uma impressora e carregar drivers de um servidor.

O exemplo de VBScript a seguir lista todos os drivers de impressora que foram instalados em um computador.

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

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista
Servidor mínimo com suporte	Windows Server 2008
Namespace	Root\CIMV2
MOF	Win32_Printer.mof
DLL	CIMWin32.dll

Confira também

CIM_Service
Classes de hardware do sistema de computador

Partilhar via

classe Win32_PrinterDriver

Sintaxe

Membros

Métodos

Propriedades

Comentários

Exemplos

Requisitos

Confira também

Comentários

Recursos adicionais