Função SetupInstallServicesFromInfSectionA (setupapi.h)

Artigo
03/01/2024

[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)