SetupInstallServicesFromInfSectionExW, fonction (setupapi.h)

Article
11/20/2024

[Cette fonction est disponible pour une utilisation dans les systèmes d’exploitation indiqués dans la section Configuration requise. Il 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 des pilotes de périphérique.]

La fonction SetupInstallServicesFromInfSectionEx effectue les 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 est requis pour avoir accès auService Control Manager et aux privilèges de modification des services.

Syntaxe

WINSETUPAPI BOOL SetupInstallServicesFromInfSectionExW(
  [in] HINF             InfHandle,
  [in] PCWSTR           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 de l’installation.

Drapeau	Signification
SPSVCINST_TAGTOFRONT 0x001	Déplacez l’étiquette de service vers l’avant de sa liste de commandes de groupe.
SPSVCINST_ASSOCSERVICE 0x002	Section AddService : marquez ce service comme pilote de fonction pour l’appareil 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ébut 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 de commandes de chargement s’il existe déjà.
SPSVCINST_NOCLOBBER_DEPENDENCIES 0x080	Ne remplacez pas la liste des dépendances s’il 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. Remarque disponible à partir de Windows Server 2003 et Windows XP.
SPSVCINST_STARTSERVICE 0x800	Section AddService : démarrez le service une fois le service installé. 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 de service (SCM).) Remarque Disponible à partir de Windows Server 2008 et Windows Vista.
SPSVCINST_NOCLOBBER_REQUIREDPRIVILEGES 0x1000	Section AddService : ne remplacez pas les privilèges requis par le service donné si le service existe déjà dans le système. Remarque 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 l’ensemble qui DeviceInfoSet spécifie. 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 de retour

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 0 (zéro). Pour obtenir des informations d’erreur étendues, appelez GetLastError.

Remarques

Note

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. Le mélange 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.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows XP [applications de bureau uniquement]
serveur minimum pris en charge	Windows Server 2003 [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	setupapi.h
bibliothèque	Setupapi.lib
DLL	Setupapi.dll

Voir aussi

Functions

Vue d’ensemble

SetupInstallFilesFromInfSection

SetupInstallFromInfSection

SetupInstallServicesFromInfSection

Partager via