Função SetupInstallServicesFromInfSectionA (setupapi.h)

  • Artigo

[Essa função está disponível para uso nos sistemas operacionais indicados na seção Requisitos. Ele poderá ser alterado ou ficar indisponível em versões subsequentes. SetupAPI não deve mais ser usado para instalar aplicativos. Em vez disso, use o Windows Installer para desenvolver instaladores de aplicativos. SetupAPI continua a ser usado para instalar drivers de dispositivo.]

A função SetupInstallServicesFromInfSection executa operações de instalação e exclusão de serviço especificadas nas seções instalação de serviço listadas na seção Serviço de um arquivo INF.

Um chamador dessa função é necessário para ter acesso ao Gerenciador de Controle de Serviço e privilégios para modificar serviços.

Sintaxe

WINSETUPAPI BOOL SetupInstallServicesFromInfSectionA(
  [in] HINF  InfHandle,
  [in] PCSTR SectionName,
  [in] DWORD Flags
);

Parâmetros

[in] InfHandle

Um identificador para o arquivo INF que contém a seção Serviço .

[in] SectionName

O nome da seção Serviço a ser processada. Você deve usar uma cadeia de caracteres terminada em nulo.

[in] Flags

Os controles para a instalação de cada serviço na seção especificada.

Sinalizador Significado
SPSVCINST_TAGTOFRONT
0x001
 Seção AddService: mova a marca de serviço para a frente de sua lista de pedidos de grupo.
SPSVCINST_DELETEEVENTLOGENTRY
0x004
 Seção DelService: exclua a entrada do log de eventos.
SPSVCINST_NOCLOBBER_DISPLAYNAME
0x008
 Seção AddService: não substitua o nome de exibição se já existir um.
SPSVCINST_NOCLOBBER_STARTTYPE
0x010
 Seção AddService: não substitua o valor do tipo inicial se o serviço já existir.
SPSVCINST_NOCLOBBER_ERRORCONTROL
0x020
 Seção AddService: não substitua o valor do controle de erro se o serviço já existir.
SPSVCINST_NOCLOBBER_LOADORDERGROUP
0x040
 Seção AddService: não substitua o grupo de pedidos de carga se ele já existir.
SPSVCINST_NOCLOBBER_DEPENDENCIES
0x080
 Seção AddService: não substitua a lista de dependências se ela já existir.
SPSVCINST_NOCLOBBER_DESCRIPTION
0x100
 Seção AddService: marque esse serviço como o driver de função para o dispositivo que está sendo instalado.
SPSVCINST_STOPSERVICE
0x200
 Seção DelService: interrompa o serviço associado especificado na entrada antes de excluir o serviço.
SPSVCINST_CLOBBER_SECURITY
0x400
 Seção AddService: as configurações de segurança do serviço serão substituídas se o serviço já existir no sistema.
Nota Disponível a partir do Windows Server 2003 e do Windows XP.
 
SPSVCINST_STARTSERVICE
0x800
 Seção AddService: inicie o serviço após a instalação do serviço. Esse sinalizador não pode ser usado para iniciar um serviço que implementa um driver de função PnP (Plug and Play) ou um driver de filtro para um dispositivo. Caso contrário, esse sinalizador pode ser usado para iniciar um serviço no modo de usuário ou kernel gerenciado pelo SCM (Service Control Manager).
Nota Disponível a partir do Windows Server 2008 e do Windows Vista.
 
SPSVCINST_NOCLOBBER_REQUIREDPRIVILEGES
0x1000
 Seção AddService: não substitua os privilégios necessários do serviço fornecido se o serviço já existir no sistema.
Nota Disponível a partir do Windows Server 2008 R2 e Windows 7.
 

Valor retornado

Se a função for bem-sucedida, o valor retornado será diferente de zero. A função chama SetLastError com ERROR_SUCCESS_REBOOT_REQUIRED se uma reinicialização do sistema for necessária.

Se a função falhar, o valor retornado será zero (0). Para obter informações de erro estendidas, chame GetLastError.

Comentários

Observação

O cabeçalho setupapi.h define SetupInstallServicesFromInfSection como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho setupapi.h
Biblioteca Setupapi.lib
DLL Setupapi.dll
Conjunto de APIs ext-ms-win-setupapi-classinstallers-l1-1-2 (introduzido no Windows 10, versão 10.0.14393)

Confira também

Funções

Visão geral

SetupInstallFilesFromInfSection

SetupInstallFromInfSection

SetupInstallServicesFromInfSectionEx