classe Win32_SystemDriver
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 |
|
| DLL |
|
Confira também
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de