Função SetupInstallServicesFromInfSectionA (setupapi.h)

Artigo
01/06/2025

[Essa função está disponível para uso nos sistemas operacionais indicados na seção Requisitos. Ele pode estar alterado ou 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 do serviço listadas na seção do Serviço de um arquivo INF.

Um chamador dessa função é necessário para ter acesso aodo Gerenciador de Controle de Serviço e privilégios para modificar os 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 do 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.

Bandeira	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. Observação 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 de modo de usuário ou kernel gerenciado pelo SCM (Service Control Manager). Observação 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 especificado se o serviço já existir no sistema. Observação Disponível a partir do Windows Server 2008 R2 e Windows 7.

Valor de retorno

Se a função for bem-sucedida, o valor retornado não será 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á 0 (zero). Para obter informações de erro estendidas, chame GetLastError.

Observações

Nota

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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

SetupInstallServicesFromInfSection registrará informações de diagnóstico no log de texto de instalação do aplicativo SetupAPI. Esse arquivo de log geralmente está desativado por padrão. Ele pode ser habilitado modificando os níveis gerais de log parte do valor de LogLevel SetupAPI, conforme descrito em Configuração de Níveis de Log de SetupAPI. Por motivos de desempenho, você só deve habilitar esse arquivo de log ao solucionar problemas. Quando o arquivo de log estiver habilitado, você poderá encontrá-lo em %windir%\inf\setupapi.app.log.

Requisitos

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

Consulte também

Funções

Visão geral

SetupInstallFilesFromInfSection

SetupInstallFromInfSection

SetupInstallServicesFromInfSectionEx

Compartilhar via