SetupInstallServicesFromInfSectionA, fonction (setupapi.h)

  • Article

[Cette fonction peut être utilisée dans les systèmes d’exploitation indiqués dans la section Configuration requise. Il sera peut-être modifié ou indisponible dans les versions ultérieures. SetupAPI ne doit plus être utilisé pour installer des applications. Utilisez plutôt Windows Installer pour développer des programmes d’installation d’applications. SetupAPI continue d’être utilisé pour installer les pilotes de périphérique.]

La fonction SetupInstallServicesFromInfSection effectue des opérations d’installation et de suppression de service spécifiées dans les sections Installation du service répertoriées dans la section Service d’un fichier INF.

Un appelant de cette fonction doit avoir accès au Gestionnaire de contrôle des services et des privilèges pour modifier les services.

Syntaxe

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

Paramètres

[in] InfHandle

Handle du fichier INF qui contient la section Service .

[in] SectionName

Nom de la section Service à traiter. Vous devez utiliser une chaîne terminée par null.

[in] Flags

Contrôles pour l’installation de chaque service dans la section spécifiée.

Indicateur Signification
SPSVCINST_TAGTOFRONT
0x001
 Section AddService : déplacez l’étiquette de service au début de sa liste de commandes de groupe.
SPSVCINST_DELETEEVENTLOGENTRY
0x004
 Section DelService : supprimez l’entrée du journal des événements.
SPSVCINST_NOCLOBBER_DISPLAYNAME
0x008
 Section AddService : ne remplacez pas le nom d’affichage s’il en existe déjà un.
SPSVCINST_NOCLOBBER_STARTTYPE
0x010
 Section AddService : ne remplacez pas la valeur du type de démarrage si le service existe déjà.
SPSVCINST_NOCLOBBER_ERRORCONTROL
0x020
 Section AddService : ne remplacez pas la valeur du contrôle d’erreur si le service existe déjà.
SPSVCINST_NOCLOBBER_LOADORDERGROUP
0x040
 Section AddService : ne remplacez pas le groupe d’ordre de chargement s’il existe déjà.
SPSVCINST_NOCLOBBER_DEPENDENCIES
0x080
 Section AddService : ne remplacez pas la liste des dépendances si elle existe déjà.
SPSVCINST_NOCLOBBER_DESCRIPTION
0x100
 Section AddService : marquez ce service comme pilote de fonction pour l’appareil en cours d’installation.
SPSVCINST_STOPSERVICE
0x200
 Section DelService : arrêtez le service associé spécifié dans l’entrée avant de supprimer le service.
SPSVCINST_CLOBBER_SECURITY
0x400
 Section AddService : les paramètres de sécurité du service sont remplacés si le service existe déjà dans le système.
Note Disponible à partir de Windows Server 2003 et Windows XP.
 
SPSVCINST_STARTSERVICE
0x800
 Section AddService : démarrez le service après l’installation du service. Cet indicateur ne peut pas être utilisé pour démarrer un service qui implémente un pilote de fonction Plug-and-Play (PnP) ou un pilote de filtre pour un appareil. Sinon, cet indicateur peut être utilisé pour démarrer un service en mode utilisateur ou en mode noyau géré par le Gestionnaire de contrôle des services (SCM).
Note Disponible à partir de Windows Server 2008 et Windows Vista.
 
SPSVCINST_NOCLOBBER_REQUIREDPRIVILEGES
0x1000
 Section AddService : ne remplacez pas les privilèges requis du service donné si le service existe déjà dans le système.
Note Disponible à partir de Windows Server 2008 R2 et Windows 7.
 

Valeur retournée

Si la fonction réussit, la valeur de retour est différente de zéro. La fonction appelle SetLastError avec ERROR_SUCCESS_REBOOT_REQUIRED si un redémarrage du système est nécessaire.

Si la fonction échoue, la valeur de retour est zéro (0). Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

Notes

L’en-tête setupapi.h définit SetupInstallServicesFromInfSection en tant qu’alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. La combinaison de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête setupapi.h
Bibliothèque Setupapi.lib
DLL Setupapi.dll
Ensemble d’API ext-ms-win-setupapi-classinstallers-l1-1-2 (introduit dans Windows 10, version 10.0.14393)

Voir aussi

Fonctions

Vue d'ensemble

SetupInstallFilesFromInfSection

SetupInstallFromInfSection

SetupInstallServicesFromInfSectionEx