Alterar método da classe Win32_SystemDriver
O método alterarclasse WMI modifica um serviço de Win32_SystemDriver . O parâmetro Win32_LoadOrderGroup representa um agrupamento de serviços do sistema definindo dependências de execução. Os serviços devem ser iniciados na ordem especificada pelo Grupo de Ordem de Carga, pois os serviços dependem uns dos outros. Esses serviços dependentes exigem a presença dos serviços anteriores para funcionar corretamente.
Este tópico usa a sintaxe MOF (Managed Object Format). Para obter mais informações sobre como usar esse método, consulte Chamando um método.
Sintaxe
uint32 Change(
[in] string DisplayName,
[in] string PathName,
[in] uint8 ServiceType,
[in] uint8 ErrorControl,
[in] string StartMode,
[in] boolean DesktopInteract,
[in] string StartName,
[in] string StartPassword,
[in] string LoadOrderGroup,
[in] string LoadOrderGroupDependencies[],
[in] string ServiceDependencies[]
);
Parâmetros
-
DisplayName [in]
-
O nome para 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. As comparações de DisplayName sempre diferenciam maiúsculas de minúsculas.
Restrições: aceita o mesmo valor que o parâmetro Name .
Exemplo: "Atdisk"
-
PathName [in]
-
O caminho totalmente qualificado para o arquivo executável que implementa o serviço.
Exemplo: \SystemRoot\System32\drivers\afd.sys
-
ServiceType [in]
-
Tipo de serviços fornecidos aos processos que os chamam.
-
1 (0x1)
-
Kernel Driver
-
2 (0x2)
-
Driver do Sistema de Arquivos
-
4 (0x4)
-
Adaptador
-
8 (0x8)
-
Driver do Reconhecedor
-
16 (0x10)
-
Processo Próprio
-
32 (0x20)
-
Compartilhar Processo
-
256 (0x100)
-
Processo Interativo
ErrorControl [in]
A gravidade do erro se esse serviço não for iniciado durante a inicialização. O valor indica a ação executada pelo programa de inicialização se ocorrer uma falha. Todos os erros são registrados pelo sistema.
Ignorar (0)
O usuário não é notificado.
Normal (1)
Normal. O usuário é notificado.
Grave (2)
O sistema é reiniciado com a última boa configuração.
Crítico (3)
O sistema tenta reiniciar com uma configuração adequada.
StartMode [in]
O modo inicial do serviço base do Windows.
Inicialização Inicial
Driver de dispositivo iniciado pelo carregador do sistema operacional.
Inicialização Inicial
Driver de dispositivo iniciado pelo carregador do sistema operacional.
Início do Sistema
Driver de dispositivo iniciado pelo processo de inicialização do sistema operacional. Esse valor só é válido para serviços do driver.
Início Automático
Serviço a ser iniciado automaticamente pelo gerenciador de controle de serviço durante a inicialização do sistema.
Início da Demanda
Serviço a ser iniciado pelo gerenciador de controle de serviço quando um processo chama o método StartService .
Desativado
Serviço que não pode ser iniciado.
DesktopInteract [in]
Um valor que, se True, o serviço pode criar ou se comunicar com as janelas na área de trabalho.
StartName [in]
O nome da conta em que o serviço é executado. Dependendo do tipo de serviço, o nome da conta pode estar na forma de DomainName\Username ou .\Username. Quando ele é executado, o processo de serviço é registrado usando um desses dois formulários. Se a conta pertencer ao domínio interno, .\Username poderá ser especificado. Se uma cadeia de caracteres vazia for especificada, 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, por exemplo, \FileSystem\Rdr ou \Driver\Xns), que o sistema de entrada e saída (E/S) usa para carregar o driver do dispositivo. Se NULL for especificado, o driver será executado com um nome de objeto padrão que o sistema de E/S cria com base no nome do serviço, por exemplo, DWDOM\Administração.
Você também pode usar o formato UPN (Nome da Entidade de Usuário) para especificar o StartName, por exemplo, Username@DomainName.
StartPassword [in]
A senha para o nome da conta especificado pelo parâmetro StartName . Especifique NULL se você não estiver alterando a senha. Especifique uma cadeia de caracteres vazia se o serviço não tiver nenhuma senha.
Observação
Ao alterar um serviço de um sistema local para uma rede ou de uma rede para um sistema local, StartPassword deve ser uma cadeia de caracteres vazia ("") e não NULL.
LoadOrderGroup [in]
O nome do grupo ao qual ele está associado. Os grupos de pedidos de carga estão contidos no registro do sistema e determinam a sequência na qual os serviços são carregados no sistema operacional. Se o ponteiro for NULL ou se apontar para uma cadeia de caracteres vazia, o serviço não pertencerá a um grupo. As dependências entre grupos devem ser listadas no parâmetro LoadOrderGroupDependencies . Os serviços na lista de grupos de ordenação de carga são iniciados primeiro, seguidos por serviços em grupos que não estão na lista de grupos de ordenação de carga, seguidos por serviços que não pertencem a um grupo. O registro do sistema tem uma lista de grupos de ordenação de carga localizados em:
HKEY_LOCAL_MACHINE\Sistema\Currentcontrolset\Controle\ServiceGroupOrder
LoadOrderGroupDependencies [in]
A lista de grupos de ordenação de carga que devem ser iniciados antes do início desse serviço. A matriz é duplamente terminada em nulo. Se o ponteiro for NULL ou se apontar para uma cadeia de caracteres vazia, o serviço não terá dependências. Os nomes de grupo devem ser prefixados pelo caractere SC_GROUP_IDENTIFIER (definido no arquivo WinSvc.h) para diferenciá-los dos nomes de serviço, pois serviços e grupos de serviços compartilham o mesmo namespace. A dependência em um grupo significa que esse serviço pode ser executado se pelo menos um membro do grupo estiver em execução após uma tentativa de iniciar todos os membros do grupo.
ServiceDependencies [in]
A lista que contém os nomes dos serviços que devem ser iniciados antes do início desse serviço. A matriz é duplamente terminada em nulo. Se o ponteiro for NULL ou se apontar para uma cadeia de caracteres vazia, o serviço não terá dependências. A dependência de um serviço significa que esse serviço só poderá ser executado se o serviço do qual ele depende estiver em execução.
Valor retornado
Retornará um valor zero (0) se o serviço tiver sido modificado com êxito, 1 (um) se a solicitação não tiver suporte e qualquer outro número para indicar um erro.
-
Êxito (0)
-
Sem suporte (1)
-
Acesso negado (2)
-
Serviços dependentes em execução (3)
-
Controle de Serviço Inválido (4)
-
O serviço não pode aceitar o controle (5)
-
Serviço Não Ativo (6)
-
Tempo limite da solicitação de serviço (7)
-
Falha desconhecida (8)
-
Caminho Não Encontrado (9)
-
Serviço já em execução (10)
-
Banco de Dados de Serviço Bloqueado (11)
-
Dependência de serviço excluída (12)
-
Falha de dependência de serviço (13)
-
Serviço Desabilitado (14)
-
Falha no logon do serviço (15)
-
Serviço marcado para exclusão (16)
-
Service No Thread (17)
-
Dependência Circular de Status (18)
-
Nome duplicado de status (19)
-
Nome Inválido de Status (20)
-
Parâmetro Inválido de Status (21)
-
Status Conta de Serviço Inválida (22)
-
Serviço de Status existe (23)
-
Serviço já pausado (24)
-
Outro (25 4294967295)
Comentários
Para alterar um serviço de um serviço de rede para o sistema local, use os seguintes valores para os parâmetros StartName e StartPassword :
StartName = "LocalSystem"
StartPassword = "" // - empty string, not NULL
Para alterar um serviço de um serviço de sistema local para um serviço de rede, use os seguintes valores para os parâmetros StartName e StartPassword :
StartName = "NT AUTHORITY\NetworkService"
StartPassword = "" // - empty string, not NULL
Requisitos
Requisito | Valor |
---|---|
Cliente mínimo com suporte |
Windows Vista |
Servidor mínimo com suporte |
Windows Server 2008 |
Namespace |
Root\CIMV2 |
Cabeçalho |
|
MOF |
|
DLL |
|