Partager via

SetupDiRegisterCoDeviceInstallers, fonction (setupapi.h)

La fonction SetupDiRegisterCoDeviceInstallers est le gestionnaire par défaut pour DIF_REGISTER_COINSTALLERS.

Syntaxe

WINSETUPAPI BOOL SetupDiRegisterCoDeviceInstallers(
  [in] HDEVINFO         DeviceInfoSet,
  [in] PSP_DEVINFO_DATA DeviceInfoData
);

Paramètres

[in] DeviceInfoSet

Handle du jeu d’informations d’appareil qui contient un élément d’informations sur l’appareil qui représente l’appareil pour lequel inscrire des co-programmes d’installation. Le jeu d’informations sur l’appareil ne doit pas contenir d’éléments distants.

[in] DeviceInfoData

Pointeur vers une structure de SP_DEVINFO_DATA qui spécifie l’élément d’informations sur l’appareil dans DeviceInfoSet.

Valeur retournée

SetupDiRegisterCoDeviceInstallers retourne TRUE si la fonction réussit. Si la fonction retourne FALSE, appelez GetLastError pour obtenir des informations d’erreur étendues.

Remarques

L’appelant de SetupDiRegisterCoDeviceInstallers doit être membre du groupe Administrateurs.

Note Seul un programme d’installation de classe doit appeler SetupDiRegisterCoDeviceInstallers et uniquement dans les situations où le programme d’installation de classe doit effectuer des opérations d’inscription de co-programme d’installation après que SetupDiRegisterCoDeviceInstallers a terminé l’opération d’inscription de co-programme d’installation par défaut. Dans de telles situations, le programme d’installation de classe doit appeler directement SetupDiRegisterCoDeviceInstallers quand le programme d’installation traite une demande de DIF_REGISTER_COINSTALLERS. Pour plus d’informations sur l’appel du gestionnaire par défaut, consultez Appel des gestionnaires de code DIF par défaut.
 
SetupDiRegisterCoDeviceInstallers lit le fichier INF de l’appareil spécifié par DeviceInfoData et crée des entrées de Registre pour inscrire les co-programmes d’installation spécifiques à l’appareil répertoriés dans le fichier INF. Les co-programmes d’installation sont répertoriés dans une section INF DDInstall.CoInstallers. Cette fonction copie également les fichiers des co-programmes d’installation, sauf si l’indicateur DI_NOFILECOPY est défini.

Si aucun pilote n’est sélectionné ou si l’appareil a un fichier INF pour Windows 9x ou Millennium Edition, cette fonction n’enregistre aucun co-programme d’installation.

L’inscription d’un nouveau co-programme d’installation spécifique à l’appareil invalide la liste actuelle des co-programmes d’installation de l’appareil. Après une inscription réussie, le programme d’installation de l’appareil met à jour sa liste de co-programmes d’installation.

Cette fonction enregistre uniquement les co-programmes d’installation spécifiques à l’appareil, et non les co-programmes d’installation de classe.

Pour plus d’informations sur l’écriture et l’inscription de co-programmes d’installation spécifiques à l’appareil, consultez Écriture d’un co-programme d’installation.

Le jeu d’informations sur l’appareil spécifié par DeviceInfoSet doit contenir uniquement des éléments sur l’ordinateur local.

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
DLL Setupapi.dll

Voir aussi

DIF_REGISTER_COINSTALLERS

SetupDiCallClassInstaller

  • Last updated on