Fonction SetupDiAskForOEMDisk (setupapi.h)
La fonction SetupDiAskForOEMDisk affiche une boîte de dialogue qui demande à l’utilisateur le chemin d’accès d’un disque d’installation OEM.
Syntaxe
WINSETUPAPI BOOL SetupDiAskForOEMDisk(
[in] HDEVINFO DeviceInfoSet,
[in, optional] PSP_DEVINFO_DATA DeviceInfoData
);
Paramètres
[in] DeviceInfoSet
Handle d’un jeu d’informations d’appareil pour l’ordinateur local. Cet ensemble contient un élément d’informations sur l’appareil qui représente l’appareil en cours d’installation.
[in, optional] DeviceInfoData
Pointeur vers une structure de SP_DEVINFO_DATA qui spécifie l’élément d’informations sur l’appareil dans DeviceInfoSet. Ce paramètre est facultatif et peut être NULL. Si ce paramètre est spécifié, SetupDiAskForOEMDisk associe le pilote au périphérique en cours d’installation. Si ce paramètre a la valeur NULL, SetupDiAskForOEMDisk associe le pilote à la liste des pilotes de classe globale pour DeviceInfoSet.
Valeur retournée
La fonction retourne TRUE si elle réussit et si le champ DriverPath de la structure SP_DEVINSTALLPARAMS est mis à jour pour refléter le nouveau chemin. Si l’utilisateur annule la boîte de dialogue, la fonction retourne FALSE et un appel à GetLastError retourne ERROR_CANCELLED.
Remarques
SetupDiAskForOEMDisk permet à l’utilisateur de parcourir les lecteurs locaux et réseau pour les fichiers d’installation OEM. Toutefois, SetupDiAskForOEMDisk est principalement conçu pour obtenir le chemin d’un pilote OEM sur un ordinateur local avant de sélectionner et d’installer le pilote d’un appareil sur cet ordinateur.
Bien que cette fonction n’échoue pas si les informations de l’appareil sont définies si pour un ordinateur distant, le résultat est d’une utilisation limitée, car le jeu d’informations sur l’appareil ne peut pas être utilisé ultérieurement avec DIF_Xxx demandes d’installation ou les fonctions SetupDiXxx qui ne prennent pas en charge les opérations sur un ordinateur distant.
En particulier, le jeu d’informations sur l’appareil ne peut pas être utilisé comme entrée avec une demande d’installation DIF_SELECTDEVICE pour sélectionner un pilote pour un appareil, suivie d’une demande d’installation DIF_INSTALLDEVICE pour installer un appareil sur un ordinateur distant.
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 |