Compartilhar via


Criar método da classe Win32_SystemDriver

O método de classe CreateWMI cria um novo serviço gerenciado pelo driver do sistema. O parâmetro Win32_LoadOrderGroup representa um agrupamento de serviços do sistema que definem 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 que a presença dos serviços antecedentes funcione 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 Create(
  [in] string  Name,
  [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

Nome [in]

Nome do serviço a ser instalado no método Create . O comprimento máximo da cadeia de caracteres é de 256 caracteres. O banco de dados do Service Control Manager preserva as maiúsculas e minúsculas dos caracteres, mas as comparações de nome de serviço sempre diferenciam maiúsculas de minúsculas. Barras (/) e barras inválidas (\) são caracteres de nome de serviço inválidos.

DisplayName [in]

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. 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]

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]

Gravidade do erro se o método Create falhar ao iniciar. Esse valor indica a ação executada pelo programa de inicialização se ocorrer falha. Todos os erros são registrados pelo sistema.

0

"Ignorar"

O usuário não é notificado.

1

"Normal"

O usuário é notificado.

2

"Grave"

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

3

"Crítico"

O sistema tenta começar com uma boa configuração.

StartMode [in]

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

Boot

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

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

Serviço a ser iniciado automaticamente pelo Service Control Manager durante a inicialização do sistema.

Manual

Serviço a ser iniciado pelo Service Control Manager quando um processo chama o método StartService .

Desativado

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

DesktopInteract [in]

Se for true, o serviço poderá criar ou se comunicar com as janelas na área de trabalho.

StartName [in]

Nome da conta na qual o serviço é executado. Dependendo do tipo de serviço, o nome da conta pode estar na forma de formato DomainName\Username ou NOME UPN (nome upn) (Username@DomainName). O processo de serviço é registrado usando um desses dois formulários quando é 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 um kernel ou drivers no nível do 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. 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

StartPassword [in]

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.

LoadOrderGroup [in]

Nome do grupo associado ao novo serviço. Os grupos de ordem de carga estão contidos no registro e determinam a sequência na qual os serviços são carregados no sistema operacional. Se o ponteiro for NULL ou se ele 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 tem uma lista de grupos de ordenação de carga localizados em:

HKEY_LOCAL_MACHINE\Sistema\Currentcontrolset\Controle\ServiceGroupOrder

LoadOrderGroupDependencies [in]

Matriz de grupos de ordenação de carga que devem ser iniciados antes desse serviço. Cada item na matriz é delimitado por NULL e a lista é encerrada por dois valores NULL . No Visual Basic ou no script, você pode passar um vbArray. 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á-lo de um nome de serviço, pois serviços e grupos de serviços compartilham o mesmo namespace. A dependência de um grupo significa que esse serviço poderá 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]

Uma matriz que contém os nomes dos serviços que devem ser iniciados antes do início desse serviço. Cada item na matriz é delimitado por NULL e a lista é encerrada por dois valores NULL . No Visual Basic ou no script, você pode passar um vbArray. Se o ponteiro for NULL ou se ele 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 de 0 (zero) se o serviço tiver sido criado com êxito, 1 (um) se a solicitação não tiver suporte e qualquer outro número para indicar um erro.

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

Classes do sistema operacional

Win32_SystemDriver