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 Microsoft Windows SDK documentation) de ne pas créer sa propre file d’attente et d’utiliser la file d’attente fournie par l’appelant à la place. Si cet indicateur est défini, les fichiers ne sont pas simplement copiés en file d’attente.
DI_NOBROWSE
Définissez cet indicateur pour désactiver la navigation si une opération de copie ne trouve pas 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 les 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 cela est 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 dans laquelle les opérations de fichier doivent être mises en file d’attente, mais pas validées.
Valeur retournée
La fonction retourne TRUE si elle réussit. Sinon, elle retourne FALSE 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’il installe un appareil d’une nouvelle classe d’appareil.
Pour installer une classe d’interface ou une classe d’appareil, utilisez SetupDiInstallClassEx.
Notes
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. 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 | Disponible dans Microsoft Windows 2000 et versions ultérieures de Windows. |
| Plateforme cible | Desktop (Expérience utilisateur) |
| En-tête | setupapi.h (inclure Setupapi.h) |
| Bibliothèque | Setupapi.lib |