SetupInstallServicesFromInfSectionA, fonction (setupapi.h)
[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.
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) |