SetupDiInstallClassExA, fonction (setupapi.h)

Article
11/20/2024

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 être 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. indicateurs peut être égal à zéro ou au niveau du bit OU des valeurs suivantes :

DI_NOVCP

Définissez cet indicateur si FileQueue est fourni.

DI_NOVCP indique à la fonction SetupInstallFromInfSection 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.

Pour plus d’informations sur la fonction SetupInstallFromInfSection, consultez la documentation du Kit de développement logiciel (SDK) Microsoft Windows.

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.

[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 est NULL, cette fonction est utilisée pour installer un programme d’installation de classe.

Reserved1

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

Reserved2

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

Valeur de retour

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

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

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

Note

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

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

Voir aussi

SetupDiCallClassInstaller

SetupDiInstallDeviceInterfaces

Partager via