Fonction SetupDiInstallClassExA (setupapi.h)

Article
08/26/2023

La fonction SetupDiInstallClassEx installe un programme d’installation de classe ou une classe d’interface.

Syntaxe

WINSETUPAPI BOOL SetupDiInstallClassExA(
  [in, optional] HWND       hwndParent,
  [in, optional] PCSTR      InfFileName,
  [in]           DWORD      Flags,
  [in, optional] HSPFILEQ   FileQueue,
  [in, optional] const GUID *InterfaceClassGuid,
                 PVOID      Reserved1,
                 PVOID      Reserved2
);

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, optional] InfFileName

Pointeur vers une chaîne terminée par NULL qui contient le nom d’un fichier INF. Ce paramètre est facultatif et peut être NULL. Si cette fonction est utilisée pour installer un programme d’installation de classe, le fichier INF contient une section INF ClassInstall32 et ce paramètre ne doit pas avoir la valeur NULL.

Si cette fonction est utilisée pour installer une classe d’interface, le fichier INF contient une section INF InterfaceInstall32.

[in] Flags

Valeur de type DWORD qui contrôle le processus d’installation. Les indicateurs peuvent être égal à zéro ou au niveau du bit OR des valeurs suivantes :

DI_NOVCP

Définissez cet indicateur si FileQueue est fourni.

DI_NOVCP demande à la fonction SetupInstallFromInfSection 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 copiés simplement en file d’attente.

Pour plus d’informations sur la fonction SetupInstallFromInfSection, consultez la documentation Microsoft Windows SDK.

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 où les opérations de fichier doivent être mises en file d’attente, mais pas validées.

[in, optional] InterfaceClassGuid

Pointeur vers un GUID qui identifie la classe d’interface à installer. Ce paramètre est facultatif et peut être NULL. Si ce paramètre est spécifié, cette fonction est utilisée pour installer la classe d’interface représentée par le GUID. Si ce paramètre a la valeur NULL, cette fonction est utilisée pour installer un programme d’installation de classe.

Reserved1

Réservé. Doit être zéro.

Reserved2

Réservé. Doit être zéro.

Valeur retournée

SetupDiInstallClassEx retourne TRUE s’il réussit. Sinon, il 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.

SetupDiInstallClassEx est généralement appelé par un programme d’installation de classe pour installer une nouvelle classe d’installation d’appareil ou une nouvelle classe d’interface d’appareil.

Note Une classe d’interface peut également être installée automatiquement en appelant SetupDiInstallDeviceInterfaces pour installer les interfaces d’appareil pour un appareil.

Notes

L’en-tête setupapi.h définit SetupDiInstallClassEx comme un 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.

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

Voir aussi

SetupDiCallClassInstaller

SetupDiInstallDeviceInterfaces

Partager via