SetupInstallServicesFromInfSectionExA, 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 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