SetupDiInstallClassA, fonction (setupapi.h)
La fonction SetupDiInstallClass installe la section ClassInstall32 du fichier INF spécifié.
Syntaxe
WINSETUPAPI BOOL SetupDiInstallClassA(
[in, optional] HWND hwndParent,
[in] PCSTR InfFileName,
[in] DWORD Flags,
[in, optional] HSPFILEQ FileQueue
);
Paramètres
[in, optional] hwndParent
Handle de la fenêtre parente pour toute interface utilisateur utilisée pour installer cette classe. Ce paramètre est facultatif et peut être NULL.
[in] InfFileName
Pointeur vers une chaîne terminée par NULL qui contient le nom du fichier INF qui contient une section INF ClassInstall32.
[in] Flags
Ces indicateurs contrôlent le processus d’installation. Il peut s’agir d’une combinaison des éléments suivants :
DI_NOVCP
Définissez cet indicateur si FileQueue est fourni. DI_NOVCP indique à la fonction SetupInstallFromInfSection (décrite dans la documentation du Kit de développement logiciel (SDK) Microsoft Windows) de ne pas créer une file d’attente propre et d’utiliser la file d’attente fournie par l’appelant à la place. Si cet indicateur est défini, les fichiers ne sont pas copiés uniquement en file d’attente.
DI_NOBROWSE
Définissez cet indicateur pour désactiver la navigation si une opération de copie ne peut pas trouver un fichier spécifié. Si l’appelant fournit une file d’attente de fichiers, cet indicateur est ignoré.
DI_FORCECOPY
Définissez cet indicateur pour toujours copier des fichiers, même s’ils sont déjà présents sur l’ordinateur de l’utilisateur. Si l’appelant fournit une file d’attente de fichiers, cet indicateur est ignoré.
DI_QUIETINSTALL
Définissez cet indicateur pour supprimer l’interface utilisateur, sauf si absolument nécessaire. Par exemple, n’affichez pas la boîte de dialogue de progression. Si l’appelant fournit une file d’attente de fichiers, cet indicateur est ignoré.
[in, optional] FileQueue
Si l’indicateur DI_NOVCP est défini, ce paramètre fournit un handle à une file d’attente de fichiers où les opérations de fichier doivent être mises en file d’attente, mais non validées.
Valeur de retour
La fonction retourne TRUE si elle réussit. Sinon, elle retourne FAUX et l’erreur journalisée peut être récupérée avec un appel à GetLastError.
Remarques
L’appelant de cette fonction doit être membre du groupe Administrateurs.
Cette fonction est appelée par un programme d’installation de classe lorsqu’elle installe un appareil d’une nouvelle classe d’appareil.
Pour installer une classe d’interface ou une classe d’appareil, utilisez SetupDiInstallClassEx.
Note
L’en-tête setupapi.h définit SetupDiInstallClass 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. 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 | Disponible dans Microsoft Windows 2000 et versions ultérieures de Windows. |
| plateforme cible | Bureau |
| d’en-tête | setupapi.h (include Setupapi.h) |
| bibliothèque | Setupapi.lib |