classe Win32_SystemDriver

  • Artigo

A classe WMIWin32_SystemDriver representa o driver do sistema para um serviço base.

A sintaxe a seguir é simplificada do código MOF (Managed Object Format) e inclui todas as propriedades herdadas. Propriedades e métodos estão em ordem alfabética, não em ordem MOF.

Sintaxe

[Dynamic, Provider("CIMWin32"), SupportsUpdate, UUID("{8502C4C5-5FBB-11D2-AAC1-006008C78BC7}"), AMENDMENT]
class Win32_SystemDriver : Win32_BaseService
{
  boolean  AcceptPause;
  boolean  AcceptStop;
  string   Caption;
  string   CreationClassName;
  string   Description;
  boolean  DesktopInteract;
  string   DisplayName;
  string   ErrorControl;
  uint32   ExitCode;
  datetime InstallDate;
  string   Name;
  string   PathName;
  uint32   ServiceSpecificExitCode;
  string   ServiceType;
  boolean  Started;
  string   StartMode;
  string   StartName;
  string   State;
  string   Status;
  string   SystemCreationClassName;
  string   SystemName;
  uint32   TagId;
};

Membros

A classe Win32_SystemDriver tem estes tipos de membros:

Métodos

A classe Win32_SystemDriver tem esses métodos.

Método Descrição
Mudar Método de classe que modifica um serviço.
ChangeStartMode Método de classe que modifica o modo inicial de um serviço.
Criar Método de classe que cria um novo serviço.
Excluir Método de classe que exclui um serviço existente.
InterrogaçãoServiço Método de classe que solicita que o serviço atualize seu estado para o gerenciador de serviços.
PauseService Método de classe que tenta colocar o serviço no estado em pausa.
ResumeService Método de classe que tenta colocar o serviço no estado retomado.
Startservice Método de classe que tenta colocar o serviço em seu estado de inicialização.
StopService Método de classe que coloca o serviço no estado parado.
UserControlService Método de classe que tenta enviar um código de controle definido pelo usuário para um serviço.

 

Propriedades

A classe Win32_SystemDriver tem essas propriedades.

AcceptPause

Tipo de dados: booliano

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32API| Estruturas de serviço| SERVICE_STATUS|dwControlsAccepted| SERVICE_ACCEPT_PAUSE_CONTINUE"), DisplayName ("Service Accepts Pause")

O serviço pode ser pausado.

Essa propriedade é herdada de Win32_BaseService.

AcceptStop

Tipo de dados: booliano

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32API| Estruturas de serviço| SERVICE_STATUS|dwControlsAccepted| SERVICE_ACCEPT_STOP"), DisplayName ("Service Accepts Stop")

O serviço pode ser interrompido.

Essa propriedade é herdada de Win32_BaseService.

Legenda

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: MaxLen (64), DisplayName ("Caption")

Descrição curta do objeto.

Essa propriedade é herdada de CIM_ManagedSystemElement.

CreationClassName

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: CIM_Key, DisplayName ("Nome da Classe")

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

Essa propriedade é herdada de CIM_Service.

Descrição

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: DisplayName ("Description")

Descrição do objeto.

Essa propriedade é herdada de CIM_ManagedSystemElement.

DesktopInteract

Tipo de dados: booliano

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32API| Estruturas de serviço| QUERY_SERVICE_CONFIG|dwServiceType| SERVICE_INTERACTIVE_PROCESS"), DisplayName ("Interage com a área de trabalho")

Esse serviço pode criar ou se comunicar com janelas na área de trabalho.

Essa propriedade é herdada de Win32_BaseService.

DisplayName

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32API| Estruturas de serviço| QUERY_SERVICE_CONFIG|lpDisplayName"), DisplayName ("Nome de Exibição")

Nome de exibição do serviço. Essa cadeia de caracteres tem um tamanho máximo de 256 caracteres. O nome é preservado por maiúsculas e minúsculas no Service Control Manager. As comparações de DisplayName sempre diferenciam maiúsculas de minúsculas.

Restrições: aceita o mesmo valor que a propriedade Name .

Exemplo: "Atdisk"

Essa propriedade é herdada de Win32_BaseService.

ErrorControl

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32API| Estruturas de serviço| QUERY_SERVICE_CONFIG|dwErrorControl"), DisplayName ("Severidade da falha de inicialização")

Gravidade do erro se esse serviço não for iniciado durante a inicialização. Esse valor indica a ação executada pelo programa de inicialização se ocorrer uma falha. Todos os erros são anotados pelo sistema de computador.

Essa propriedade é herdada de Win32_BaseService.

Ignorar ("Ignorar")

O usuário não é notificado.

Normal ("Normal")

O usuário é notificado.

Grave ("Grave")

Sistema é reiniciado com a última configuração bem-sucedida conhecida.

Crítico ("Crítico")

O sistema tenta reiniciar com uma configuração adequada.

Desconhecido ("Desconhecido")

A causa da falha é desconhecida.

ExitCode

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32API| Estruturas de serviço | SERVICE_STATUS|dwWin32ExitCode"), DisplayName ("Exit Code")

Código de erro do Windows que define os problemas encontrados ao iniciar ou parar o serviço. Esta propriedade é definida como ERROR_SERVICE_SPECIFIC_ERROR (1066) quando o erro é exclusivo do serviço representado por essa classe, e as informações sobre o erro estão disponíveis na propriedade ServiceSpecificExitCode . O serviço define esse valor como NO_ERROR ao executar e novamente após o encerramento normal.

Essa propriedade é herdada de Win32_BaseService.

InstallDate

Tipo de dados: datetime

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("MIF. DMTF| ComponentID|001.5"), DisplayName ("Data de Instalação")

O objeto foi instalado. Essa propriedade não precisa de um valor para indicar que o objeto está instalado.

Essa propriedade é herdada de CIM_ManagedSystemElement.

Nome

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: Chave

Identificador exclusivo para o serviço que fornece uma indicação da funcionalidade que é gerenciada. Essa funcionalidade é descrita mais detalhadamente na propriedade Description do objeto.

Essa propriedade é herdada de CIM_Service.

PathName

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32API| Estruturas de serviço | QUERY_SERVICE_CONFIG|lpBinaryPathName"), DisplayName ("Nome do Caminho do Arquivo")

Caminho totalmente qualificado para o arquivo binário de serviço que implementa o serviço.

Exemplo: "\SystemRoot\System32\drivers\afd.sys"

Essa propriedade é herdada de Win32_BaseService.

ServiceSpecificExitCode

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32API| Estruturas de serviço | SERVICE_STATUS|dwServiceSpecificExitCode"), DisplayName ("Código de Saída Específico do Servidor")

Código de erro específico do serviço para erros que ocorrem enquanto o serviço está iniciando ou parando. Os códigos de saída são definidos pelo serviço representado por essa classe. Esse valor só é definido quando o valor da propriedade ExitCode é ERROR_SERVICE_SPECIFIC_ERROR (1066).

Essa propriedade é herdada de Win32_BaseService.

Servicetype

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32API| Estruturas de serviço | QUERY_SERVICE_CONFIG|dwServiceType"), DisplayName ("Tipo de Serviço")

Tipo de serviço fornecido a processos de chamada.

Essa propriedade é herdada de Win32_BaseService.

Os valores são:

Driver do Kernel ("Driver do Kernel")

Driver do Sistema de Arquivos ("Driver do Sistema de Arquivos")

Adaptador ("Adaptador")

Driver do Reconhecedor ("Driver do Reconhecedor")

Processo Próprio ("Processo Próprio")

Processo de compartilhamento ("Processo de compartilhamento")

Processo Interativo ("Processo Interativo")

Iniciado

Tipo de dados: booliano

Tipo de acesso: Somente leitura

Qualificadores: DisplayName ("Iniciado")

O serviço foi iniciado.

Essa propriedade é herdada de CIM_Service.

StartMode

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: DisplayName ("Modo de Início")

Modo de início do driver do sistema.

Essa propriedade é herdada de Win32_BaseService.

Inicialização ("Inicialização")

Driver de dispositivo iniciado pelo carregador do sistema operacional (válido somente para serviços de driver).

Sistema ("Sistema")

Driver de dispositivo iniciado pelo processo de inicialização do sistema operacional. Esse valor só é válido para serviços do driver.

Automático ("Automático")

Serviço a ser iniciado automaticamente pelo gerenciador de controle de serviço durante a inicialização do sistema.

Manual ("Manual")

Serviço a ser iniciado pelo gerenciador de controle de serviço quando um processo chama o método StartService .

Desabilitado ("Desabilitado")

Serviço que não pode mais ser iniciado.

Startname

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32API| Estruturas de serviço | QUERY_SERVICE_CONFIG|lpServiceStartName"), DisplayName ("Nome da Conta Inicial")

Nome da conta na qual o serviço é executado. Dependendo do tipo de serviço, o nome da conta pode estar na forma de DomainName\Username. O processo de serviço será registrado usando um desses dois formulários quando for executado. Se a conta pertencer ao domínio interno, .\Username poderá ser especificado. Se NULL for especificado, o serviço será conectado como a conta LocalSystem. Para drivers de kernel ou de nível de sistema, StartName contém o nome do objeto do driver (ou seja, \FileSystem\Rdr ou \Driver\Xns) que o sistema de entrada e saída (E/S) usa para carregar o driver do dispositivo. Além disso, se NULL for especificado, o driver será executado com um nome de objeto padrão criado pelo sistema de E/S com base no nome do serviço.

Exemplo: "DWDOM\Administração"

Essa propriedade é herdada de Win32_BaseService.

State

Tipo de dados: cadeia de caracteres

Tipo de acesso: leitura/gravação

Qualificadores: MappingStrings ("Win32API| Estruturas de serviço | SERVICE_STATUS|dwCurrentState "), DisplayName ("State")

Estado atual do serviço base.

Essa propriedade é herdada de Win32_BaseService.

Os valores são:

Parado ("Parado")

Iniciar Pendente ("Iniciar Pendente")

Parar Pendente ("Parar Pendente")

Em execução ("Em execução")

Continuar Pendente ("Continuar Pendente")

Pausa pendente ("Pausa pendente")

Pausado ("Pausado")

Desconhecido ("Desconhecido")

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 são:

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")

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")

Digite o nome do sistema que hospeda esse serviço.

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.

TagId

Tipo de dados: uint32

Tipo de acesso: Somente leitura

Qualificadores: MappingStrings ("Win32API| Estruturas de serviço | QUERY_SERVICE_CONFIG|dwTagId"), DisplayName ("ID da marca")

Valor de marca exclusivo para esse serviço no grupo. Um valor de 0 (zero) indica que o serviço não recebeu uma marca. Uma marca pode ser usada para ordenar a inicialização do serviço dentro de um grupo de ordem de carga especificando um vetor de ordem de marca no registro localizado em:

Essa propriedade é herdada de Win32_BaseService.

HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\GroupOrderList.

As marcas são avaliadas apenas para os serviços do tipo inicial do Driver do Kernel e do Driver do Sistema de Arquivos que têm os modos inicialização ou inicialização do sistema.

Comentários

A classe Win32_SystemDriver é derivada de Win32_BaseService.

Exemplos

O exemplo Listar Drivers do Sistema VBScript Exibe drivers do sistema instalados em um arquivo HTML.

O exemplo do PowerShell a seguir recupera várias propriedades dos drivers do sistema em execução em um computador.

Get-WmiObject -Class Win32_SystemDriver | Where-Object -FilterScript {$_.State -eq "Running"} | Where-Object -FilterScript {$_.StartMode -eq "Manual"} | Format-Table -Property Name,DisplayName

Requisitos

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

Confira também

Win32_BaseService

Classes do sistema operacional