classe Win32_BaseService

  • Artigo

O Win32_BaseServiceclasse WMI abstrata representa objetos executáveis instalados em um banco de dados do Registro mantido pelo Service Control Manager. O arquivo executável associado a um serviço pode ser iniciado no momento da inicialização por um programa de inicialização ou pelo sistema. Ele também pode ser iniciado sob demanda pelo Service Control Manager. Qualquer serviço ou processo que não pertence a um usuário específico e que fornece uma interface para alguma funcionalidade compatível com o sistema de computador é um descendente (ou membro) dessa classe.

Exemplo: o serviço cliente dhcp (protocolo de configuração de host dinâmico) em um sistema de computador que executa o Windows Server.

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

Sintaxe

[SupportsCreate, CreateBy("Create"), SupportsDelete, DeleteBy("DeleteInstance"), Abstract, Provider("CIMWin32"), UUID("{8502C4C4-5FBB-11D2-AAC1-006008C78BC7}"), DisplayName("System Drivers and Services"), AMENDMENT]
class Win32_BaseService : CIM_Service
{
  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_BaseService tem estes tipos de membros:

Métodos

A classe Win32_BaseService tem esses métodos.

Método Descrição
Mudar Modifica um serviço.
ChangeStartMode Modifica o modo de início de um serviço.
Criar Cria um serviço novo.
Excluir Exclui um serviço existente.
InterrogateService Solicita que o serviço atualize seu estado para o gerenciador de serviços.
PauseService Tenta colocar o serviço no estado de pausado.
ResumeService Tenta colocar o serviço no estado de reiniciado.
Startservice 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 Tenta enviar um código de controle definido pelo usuário para um serviço.

Propriedades

A classe Win32_BaseService 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.

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.

Legenda

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

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

Breve descrição 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 ser exibida na cadeia de herança usada na criação de uma instância. Quando usada com as outras propriedades de chave da classe , a 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")

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

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 Gerenciador de Controle de Serviço. Comparações de DisplayName sempre diferenciam maiúsculas de minúsculas.

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

Exemplo: "Atdisk"

ErrorControl

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

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

Gravidade do erro. Falha ao iniciar o serviço. O valor indica a ação executada pelo programa de inicialização se ocorrer falha. Todos os erros são anotados pelo sistema de computador.

Ignorar ("Ignorar")

O usuário não é notificado.

Normal ("Normal")

O usuário é notificado.

Grave ("Grave")

Sistema reiniciado com a última configuração válida.

Crítico ("Crítico")

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

Desconhecido ("Desconhecido")

A ação executada não é especificada.

ExitCode

Tipo de dados: uint32

Tipo de acesso: Somente leitura

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

Definir quaisquer 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.

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 do serviço, que fornece uma indicação da funcionalidade gerenciada. Essa funcionalidade é descrita mais detalhadamente na propriedade Description do objeto.

Essa propriedade é herdada de CIM_ManagedSystemElement.

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"

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 exitCodeproperty é ERROR_SERVICE_SPECIFIC_ERROR (1066).

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

Serviço fornecido para processos de chamada.

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: Substituição ("StartMode"), DisplayName ("Modo de Início")

Modo de início do serviço base do Windows.

Essa propriedade é herdada de CIM_Service.

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" ou formato UPN (Username@DomainName). 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".

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.

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

Windows Server 2008 e Windows Vista: Essa propriedade é somente leitura.

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, recarregamento de 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")

Falha de pred ("Falha de pred")

Iniciando ("Iniciando")

Parando ("Parando")

Serviço ("Serviço")

Estressado ("Estressado")

NonRecover ("NonRecover")

Sem contato ("Sem contato")

Comm Perdido ("Comm Perdido")

SystemCreationClassName

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: Propagado ("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: Propagado ("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 o serviço star tup dentro de um grupo de pedidos de carga especificando um vetor de ordem de marca no registro localizado em: HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\GroupOrderList. As marcas são avaliadas apenas para os serviços de tipo inicial do Driver do Kernel e do Driver do Sistema de Arquivos que têm modos inicialização ou início do sistema.

Comentários

A classe Win32_BaseService é derivada de CIM_Service.

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

CIM_Service

Classes do sistema operacional