Função SetupInstallServicesFromInfSectionExA (setupapi.h)

Artigo
11/20/2024

[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 SetupInstallServicesFromInfSectionEx executa operações de instalação e exclusão de serviço especificadas nas seções de 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 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 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 da instalação.

Bandeira	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 ordem 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. 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.

[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 de 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 que DeviceInfoSet especifica. Para obter mais informações, consulte o guia do programador de DDK. (Esse recurso pode não estar disponível em alguns idiomas

e países.)

Reserved1

Reservado.

Reserved2

Reservado.

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

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

Consulte também

Funções

Visão geral

SetupInstallFilesFromInfSection

SetupInstallFromInfSection

SetupInstallServicesFromInfSection

Compartilhar via