SetupInstallServicesFromInfSectionW, fonction (setupapi.h)

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

Syntaxe

WINSETUPAPI BOOL SetupInstallServicesFromInfSectionW(
  [in] HINF   InfHandle,
  [in] PCWSTR 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.

Drapeau	Signification
SPSVCINST_TAGTOFRONT 0x001	Section AddService : déplacez l’étiquette de service vers l’avant 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 complet 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’ordres de chargement s’il existe déjà.
SPSVCINST_NOCLOBBER_DEPENDENCIES 0x080	Section AddService : 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.

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

SetupInstallServicesFromInfSection journalisera les informations de diagnostic dans le journal de texte d’installation de l’application SetupAPI . Ce fichier journal est généralement désactivé par défaut. Elle peut être activée en modifiant les niveaux de journalisation général partie de la valeur setupAPI LogLevel, comme décrit dans Définition des niveaux de journalisation SetupAPI. Pour des raisons de performances, vous devez uniquement activer ce fichier journal lors de la résolution d’un problème. Lorsque le fichier journal est activé, vous pouvez le trouver à %windir%\inf\setupapi.app.log.

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
ensemble d’API	ext-ms-win-setupapi-classinstallers-l1-1-2 (introduit dans Windows 10, version 10.0.14393)

Voir aussi

Functions

Vue d’ensemble

SetupInstallFilesFromInfSection

SetupInstallFromInfSection

SetupInstallServicesFromInfSectionEx