Classe CIM_Service (Provedores WMI CIMWin32)

A classe CIM_Service representa um elemento lógico que contém informações para representar e gerenciar a funcionalidade fornecida por um dispositivo ou recurso de software. Um serviço é um objeto de uso geral para configurar e gerenciar a implementação da funcionalidade; não é a funcionalidade em si.

Importante

As classes CIM do DMTF (Distributed Management Task Force) (Common Information Model) são as classes pai nas quais as classes WMI são criadas. Atualmente, o WMI dá suporte apenas aos esquemas de versão cim 2.x.

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

[Abstract, UUID("{8502C527-5FBB-11D2-AAC1-006008C78BC7}"), DisplayName("Services (CIM)"), AMENDMENT]
class CIM_Service : CIM_LogicalElement
{
  string   Caption;
  string   Description;
  datetime InstallDate;
  string   Status;
  string   CreationClassName;
  string   Name;
  boolean  Started;
  string   StartMode;
  string   SystemCreationClassName;
  string   SystemName;
};

Membros

A classe CIM_Service tem estes tipos de membros:

• Métodos
• Propriedades

Métodos

A classe CIM_Service tem esses métodos.

Método	Descrição
Startservice	Tenta colocar o serviço em seu estado de inicialização. Não implementado pelo WMI.
StopService	Método de classe que coloca o serviço no estado parado. Não implementado pelo WMI.

Propriedades

A classe CIM_Service tem essas propriedades.

Legenda

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

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

Uma breve descrição textual 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 classe ou subclasse usada na criação de uma instância. Quando usada com outras propriedades de chave da classe , essa propriedade permite que todas as instâncias da classe e suas subclasses sejam identificadas exclusivamente.

Descrição

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: DisplayName ("Description")

Uma descrição textual do objeto .

Essa propriedade é herdada de CIM_ManagedSystemElement.

InstallDate

Tipo de dados: datetime

Tipo de acesso: Somente leitura

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

Indica quando o objeto foi instalado. A falta de um valor não indica que o objeto não está instalado.

Essa propriedade é herdada de CIM_ManagedSystemElement.

Nome

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: Substituição ("Nome"), Chave

A propriedade Name identifica exclusivamente o serviço e fornece uma indicação da funcionalidade gerenciada. Essa funcionalidade é descrita em mais detalhes na propriedade Description do objeto.

Iniciado

Tipo de dados: booliano

Tipo de acesso: Somente leitura

Qualificadores: DisplayName ("Started")

Se TRUE, o serviço foi iniciado.

StartMode

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

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

Indica se o serviço é iniciado automaticamente (por exemplo, por um sistema operacional) ou iniciado somente após a solicitação.

Automático ("Automático")

Manual ("Manual")

Status

Tipo de dados: cadeia de caracteres

Tipo de acesso: Somente leitura

Qualificadores: MaxLen (10), DisplayName ("Status")

Cadeia de caracteres que indica o status atual do objeto. As status operacionais e não operacionais podem ser definidas. Os status operacionais podem incluir "OK", "Degradado" e "Falha de Pred". "Pred Fail" indica que um elemento está funcionando corretamente, mas está prevendo uma falha (por exemplo, uma unidade de disco rígido habilitada para SMART).

As status não operacionais podem incluir "Erro", "Iniciando", "Parando" e "Serviço". O "Serviço" pode ser aplicado durante o disco espelho-resilvering, recarregando 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")

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

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 o serviço.

Comentários

A classe CIM_Service é derivada de CIM_LogicalDevice.

O WMI não implementa essa classe. Para classes WMI derivadas de CIM_Service, consulte Classes Win32.

Esta documentação é derivada das descrições da classe CIM publicadas pelo DMTF. A Microsoft pode ter feito alterações para corrigir erros secundários, estar em conformidade com os padrões de documentação do SDK da Microsoft ou fornecer mais informações.

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_LogicalElement