SetupInstallServicesFromInfSectionExA, fonction (setupapi.h)

Article
03/04/2024

[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 SetupInstallServicesFromInfSectionEx effectue des opérations d’installation et de suppression de service spécifiées dans les sections Installation de 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 SetupInstallServicesFromInfSectionExA(
  [in] HINF             InfHandle,
  [in] PCSTR            SectionName,
  [in] DWORD            Flags,
  [in] HDEVINFO         DeviceInfoSet,
  [in] PSP_DEVINFO_DATA DeviceInfoData,
       PVOID            Reserved1,
       PVOID            Reserved2
);

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.

Indicateur	Signification
SPSVCINST_TAGTOFRONT 0x001	Déplacez l’étiquette de service au début de sa liste de commandes de groupe.
SPSVCINST_ASSOCSERVICE 0x002	Section AddService : marquez ce service comme pilote de fonction pour le périphérique en cours d’installation.
SPSVCINST_DELETEEVENTLOGENTRY 0x004	Supprimez l’entrée du journal des événements pour un service spécifié.
SPSVCINST_NOCLOBBER_DISPLAYNAME 0x008	Ne remplacez pas le nom complet s’il en existe déjà un.
SPSVCINST_NOCLOBBER_STARTTYPE 0x010	Ne remplacez pas la valeur du type de démarrage si le service existe déjà.
SPSVCINST_NOCLOBBER_ERRORCONTROL 0x020	Ne remplacez pas la valeur du contrôle d’erreur si le service existe déjà.
SPSVCINST_NOCLOBBER_LOADORDERGROUP 0x040	Ne remplacez pas le groupe d’ordre de chargement s’il existe déjà.
SPSVCINST_NOCLOBBER_DEPENDENCIES 0x080	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.

[in] DeviceInfoSet

Pointeur facultatif vers un handle vers un jeu d’informations d’appareil. Pour plus d’informations, consultez le Guide du programmeur DDK. (Cette ressource peut ne pas être disponible dans certaines langues

et pays.)

[in] DeviceInfoData

Pointeur facultatif vers la structure SP_DEVINFO_DATA qui fournit un contexte à un élément spécifique dans le jeu spécifié par DeviceInfoSet . Pour plus d’informations, consultez le Guide du programmeur DDK. (Cette ressource peut ne pas être disponible dans certaines langues

et pays.)

Reserved1

Réservé.

Reserved2

Réservé.

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

Voir aussi

Fonctions

Vue d'ensemble

SetupInstallFilesFromInfSection

SetupInstallFromInfSection

SetupInstallServicesFromInfSection

Partager via