Função SetupInstallServicesFromInfSectionExA (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 SetupInstallServicesFromInfSectionEx 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 SetupInstallServicesFromInfSectionExA(
  [in] HINF             InfHandle,
  [in] PCSTR            SectionName,
  [in] DWORD            Flags,
  [in] HDEVINFO         DeviceInfoSet,
  [in] PSP_DEVINFO_DATA DeviceInfoData,
       PVOID            Reserved1,
       PVOID            Reserved2
);

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.

Sinalizador Significado
SPSVCINST_TAGTOFRONT
0x001
 Mova a marca de serviço para a frente de sua lista de pedidos de grupo.
SPSVCINST_ASSOCSERVICE
0x002
 Seção AddService: marque esse serviço como o driver de função para o dispositivo que está sendo instalado.
SPSVCINST_DELETEEVENTLOGENTRY
0x004
 Exclua a entrada de log de eventos para um serviço especificado.
SPSVCINST_NOCLOBBER_DISPLAYNAME
0x008
 Não substitua o nome de exibição se já existir um.
SPSVCINST_NOCLOBBER_STARTTYPE
0x010
 Não substitua o valor do tipo inicial se o serviço já existir.
SPSVCINST_NOCLOBBER_ERRORCONTROL
0x020
 Não substitua o valor do controle de erro se o serviço já existir.
SPSVCINST_NOCLOBBER_LOADORDERGROUP
0x040
 Não substitua o grupo de pedidos de carga se ele já existir.
SPSVCINST_NOCLOBBER_DEPENDENCIES
0x080
 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.
 

[in] DeviceInfoSet

Um ponteiro opcional para um identificador para um conjunto de informações do dispositivo. Para obter mais informações, consulte o Guia do Programador do DDK. (Esse recurso pode não estar disponível em alguns idiomas

e países.)

[in] DeviceInfoData

Um ponteiro opcional para a estrutura SP_DEVINFO_DATA que fornece um contexto para um elemento específico no conjunto especificado por DeviceInfoSet . Para obter mais informações, consulte o Guia do Programador do DDK. (Esse recurso pode não estar disponível em alguns idiomas

e países.)

Reserved1

Reservado.

Reserved2

Reservado.

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 SetupInstallServicesFromInfSectionEx 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

Confira também

Funções

Visão geral

SetupInstallFilesFromInfSection

SetupInstallFromInfSection

SetupInstallServicesFromInfSection